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PREFACE 


This manual describes the extensions for use with the BASIC/RT-11, 
BASIC/PTS-11, and BASIC/CAPS-11 systems. The extensions enable you to 
utilize PDP-11 lab peripherals such as LPS11, ARI11, and ODR11-K. 
Unless stated otherwise, the descriptions of all routines in this 
manual apply to the systems mentioned above. 


The routines for these peripherals are provided in library form that 
can be linked with a user program. The user should have a programming 
knowledge of BASIC and some understanding of the peripherals. 


The following table describes the documentation conventions used in 
this manual. 


Convention Meaning 
<LF> Line feed 
<CR> Carriage return 
"OF 2CTRE Used with special system control 


® 


Square Brackets [ ] 


Lower case letter or 
lower case letter 
followed by a digit 
(a,b,x0,yl) 


Lower case letter 
followed by a dollar 
Sign (a$,x$) 

Upper case letter 
(A,B,X,Y) 


Y axis 


X axis 


characters. Depress CTRL key while 
striking designated character. 


Altmode 
Optional arguments are enclosed. 


Value to be supplied by user. May 
be any valid arithmetic expression. 


String to be supplied by user. May 
be string constant (enclosed in 
quotes) or variable (AS). 


Numeric variable whose value will 
be determined by call or an array 
name. 


The vertical axis. 


The horizontal axis. 


The following manuals are necessary references for this manual: 


RT-11 System Reference Manual 
DEC-1]-ORUGA-C-D 


BASIC-11 Language Reference Manual 
DEC-11-LIBBA~-B-D 


BASIC/RT-11 Language Reference Manual 
DEC-11-LBACA-D-D 


BASIC/PTS User's Manual 
DEC-11-LPTBA-A-D 


BASIC/CAPS-11 User's Manual 
DEC-11-LIBCA-A-D 


LPS11 User's Guide 
DEC-~11-—-HLPGA-C-D 


AR11 User's Guide 
DEC-11-HARUG 


DR11-K Interface User's Guide and Maintenance Manual 
EK-DRL1K-MM-O001 


BY ga 


CHAPTER 1 


INTRODUCTION 


BASIC Extensions support the RT-11, CAPS-11, and PTS-1ll systems, and 
the following hardware: 


LPS11 Laboratory Peripheral System 
AR11 Analog Reail-Time:-Interface 
DR11-K Digital Input/Output Interface 


The Laboratory Peripheral System (LPS) support can utilize LPS11, AR11 
and DR11-K to sample and display data from analog to digital 
converters, digital input/output, or external events. LPS support 
contains 23 routines to control LPS11, AR11 and DR11-K. These 23 
routines are divided into five categories according to their function. 
Each category is supplied as a module. The first module, LPSO, is the 
main module which contains all necessary support routines for using 
the other four modules. This module is required but the other four 
are optional. 


The support for the peripherals consists of a library of routines that 
can be controlled by a user program through a CALL statement. The 
format of the CALL statement is: 

CALL "name"(argument list) 


Under BASIC/CAPS-11, the routines can also be called by a statement of 
the form: 


name (argument list) 


The function and limitation of each routine is described in detail in 
the following chapter. 


™. 


CHAPTER 2 


LABORATORY PERIPHERAL SYSTEM SUPPORT 


2.1 GENERAL FEATURES 


Laboratory Peripheral System support for BASIC-ll allows a user _ to 
utilize the LPS hardware which includes LPS11, AR11 and up to 16 
DR11-K. LPS support enables the sampling and displaying in a 
real-time environment of a variety of data from analog to digital 
converters, digital input/output, and external events. Sampling is 
controlled by crystal clocks and/or Schmitt triggers; it is possible 
to specify such parameters as sampling rate and response time thus 
allowing maximum flexibility. 


NOTE 


In a multiple DR11-K system, there must 
be a difference of 10(octal) between 
each unit in the interrupt and _ vector 
address. The status register address 
decreases by 10(octal) while the vector 
address increases by 10(octal). 


All LPS routines are issued by the BASIC CALL statement allowing 
experienced PDP~1l assembly language programmers to easily include or 
modify the routines to meet particular (or special) requirements. 


2.2 DESCRIPTION OF ROUTINES 


The BASIC Extensions contain 23 routines to control the following 
options on the LPS11 hardware: 


LPSAD-12 12-bit ADC, sample and hold, 8-channel 
multiplexer, and LED (light emitting diodes) 
6-digit programmable decimal readout display. 

LPSAD-NP Direct memory access (DMA) option for the LPSAD-12 


ADC. 

LPSAG Four differential preamplifiers with +or-l1V input. 
Maximum of 4 LPSAGs per LPS11-S system. 

LPSAG-VG Four independently selectable multigain 
differential preamplifiers. 

LPSAM 8-channel expansion multiplexer. 

LPSSA Second sample and hold for a dual sample and hold 
configuration. 

LPSKW Programmable real-time clock and _ two Schmitt 
triggers. 

LPSVC Display control includina two 12-bit DACS. This 


2nd 


LPSDR 
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controller is capable of handling Digital's VR14 
and VR20 scopes. 

16-bit buffered digital I/O with drive 
capabilities and two programmable normally open 
(n.o.) relays. LPSDR cannot be used if DR11-K is 
used. 


The 23 routines are divided into 5 categories according to 
function. Each category is supplied as a separate module. 


The following 


list is a summary of the routines available 


controlling LPS hardware and a brief description of each: 


MODULE LPSO (This module is always required.) 


USE 


ACC 
RDB 


Defines array(s) to be used for storage of 
data. 

Allows access to an entire array. 

Returns the next data point from a_ specified 
buffer. 


MODULE LPS1 (ANALOG TO DIGITAL CONVERSION) 


ADC 


RTS 


LED 


CVSG 


Initiates an A/D conversion on aé_e specified 
channel and returns the result to the user. 
Performs real-time buffered/clocked sampling 
of the A/D. 

Displays a numeric value on the Light 
Emitting Diodes. 

Returns the next data value and gain in two 
separate variables. 


MODULE LPS2 (REAL-TIME CLOCK) 


SETR 


SEL 


HIST 


WAIT 
RTIM 


Sets clock running at a designated rate and 
mode. 

Sets clock running at a designated rate and 
initiates some action after a specified 
number of seconds have elapsed. 

Performs histogram sampling using a_ timed 
Schmitt trigger. 

Waits for a specified event to occur. 

Returns the value of the internal software 
clock counter. 


MODULE LPS3 (DIGITAL I/O) 


DIR 
DOR 
DRS 


REL 
IPK 


Reads Digital Input register. 

Writes Digital Output register. 

Performs sampling of the Digital Input 
register. 

Closes or opens one of two relays. 

Reads a value from a register or writes a 
value into a register. 


MODULE LPS4 (DISPLAY) 


CLRD 


PUTD 


Defines display buffer and optionally clear 
or scale the data in it. 
Puts data into data buffer. 


their 


for 
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DIS Displays data with incrementing x and 
variable y whenever BASIC is waiting for I/O. 

FSH Displays a Single complete sweep of data with 
incrementing x and variable y. 

DXY Displays data with variable x and y values 
whenever BASIC is waiting for I/O. 

FXY Displays a single complete sweep of data with 


variable x and y values. 


Module LPSO is the main module and contains not only the USE, ACC, and 
RDB routines, but also all necessary support routines for the other 
modules. Therefore, it must be included, although the other modules 
are optional. 


Data buffers used by the LPS routines differ from the normal arrays in 
BASIC in that they use only one word of storage per data element 
rather than two. This is because all LPS data is no larger than 
2**16-1 and can be stored as unsigned 16-bit data. All data buffers 
must be defined by a USE routine before they are accessed by any other 
LPS routines. The USE routine allows the user to partition and make 
equivalent arrays for ease in displaying and manipulating common data. 
All data buffers defined in the USE routine are circular with internal 
pointers keeping track of where data is to be placed next and/or 
retrieved. 


2.3 MODULE LPSO (REQUIRED MODULE) 


2.3.1 Defining the Buffer (USE) 


The USE routine defines buffer areas for use with the ACC, RDB, RTS, 
HIST, DRS, CLRD, PUTD, DIS, FSH, DXY and FXY routines. This routine 
sets up internal pointers allowing circular buffering and data overrun 
and/or nonexistent data checking. A maximum of five buffers may be 
specified, all of which must be given in a single USE statement. All 
areas defined in the USE statement must have been previously 
dimensioned in a DIM statement. 


The format of the USE call is: 
CALL: “USES (ADT) JaIBIG) lyesceySl( ETT 


where 


A,B,C are the names of previously dimensioned array(s). 
May be 5 different arrays or array names may be 
repeated. 

Lig ee represents a valid subscript for the array or 0 
which indicates the entire array. 


The USE routine defines buffer areas required for storage of data. 
These areaS may be a partitioned array which can be made equivalent to 
one large array. The following examples illustrate all aspects of the 
USE routine. Note that the size of an area defined in a DIM statement 
is one half that desired. This is because BASIC uses two words to 
store data whereas the LPS data is stored in one word. 


LABORATORY PERIPHERAL SYSTEM SUPPORT 


Example: 


Define areas A, B, and C to have 100, 200, and 300 data points 
respectively. 


LO DIM AChOeRCLOOs yO CLO) 
2O CALL "USE" Cry Wel) 


Example: 


Define area A to consist of three parts, the first having 10 data 
points and the second and third having 20 each. Then define a final 
area having access to all of the array A (including the zero subscript 
element). 


NOTE 


Read the USE statement from left to 
right establishing the separate areas 
based on previously defined members of 
the same array. Only when the starting 
address of the next array is less’ than 
the previous one will entire access to 
the array be allowed by the following 
array. 


The subscripts in the declaration are used to define pseudo partition 
names which can be used in other LPS statements which require arrays. 


LO TEM ACRS SG 
20 (TALL "USE" CACTI yACTT yACSLI 9 AD 


In this example, each declaration of the array A has a_e unique 
description. A, which is equivalent to A(0), is different than A(l), 
A(11), and A(31). The following figure illustrates the partitioning 
of the array A due to the preceding example. 


A(1) ( 
A(0) OR A 
A(11) 
A(31) ( 
In the example, the partitioning occurs as follows: A(l) defines a 


buffer array starting at position A(1l) in the array A and ending at 
the last position in the array. Since A(1l) is declared immediately 
following it, the end of the array for A(1) is redefined to be one 
less than the A(1l) position. At this point, A(1l) goes from the lst 
position in the array to the 10th, and A(1l) goes from the llth 
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position in the array to the 50th. When A(3l1) is declared immediately 
following A(1l), A(11) is redefined to go from the llth position in 
the array to the 30th and A(31) goes from the 31st position to the 
50th. Now the partitioned array consists of three parts. The first 
part is called A(1) and is 10 locations in size. The second part is 
called A(1ll) and is 20 locations in size. The third part is called 
A(31) and is also 20 locations in size. The final declaration in the 
example is A or A(0) (both are equivalent), which allows access to the 
entire array A. This happens because the position in the array A of 
A(0) is less than the last declaration in the USE statement, i.e., 
A(31), and a new partitioning is’ started. This new partitioning 
begins at A(0) and proceeds until the end of the array A. The rules 
to continue from this point are the same as previously discussed and 
further partitioning could be defined if necessary. Note that every 
declaration in the USE statement must be unique, i.e., a statement of 
the form USE(A,A(0)) results in the first array A having an area of 
zero length. Since the second array is not unique in name, any 
reference to it later by other LPS statements actually refers to the 
array A and not A(0). Since A has zero length, the buffer declaration 
is useless. 


2.3.2 Allowing Access to a Buffer (ACC) 


The ACC routine allows full access to the specified array by the RDB 
routine. The form of the call is: 


CALL "ACC" (A[ (i) ]) 
where 


A[(i)] is a buffer previously declared in a call to. the 
USE routine. 


A call to ACC resets all buffer pointers of the array A to allow full 
access to it by the RDB and PUTD routines. The PUTD pointer is placed 
at the end of the array and the RDB pointer is placed at the 
beginning. Since the PUTD pointer is placed at the end of the array, 
the buffer is considered full. 


Example: 
Allow full access to the array H and the buffer area of array A. 


10 DIM A(25) ,H(20) 

20 CALL “USE"(A(1),A(11),A(31) ,A,H) 
30 wee 

40 ..e- 


100 CALL "ACC" (H) 

110 CALL "ACC" (A(11)) 
1200 wacae 

ESO & ous 
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2.3.3 Returning Data from a Buffer (RDB) 





RDB 


A call to the RDB routine returns the next data value from the 
specified buffer in the target variable. The value returned from RDB 
contains the data value with the gain in the most significant digits. 
The returned data is formatted. The form of the call is: 


CALL "RDB" (A[(i)],B) 


where 
A[(i)] is a buffer previously defined in a call to. the 
USE routine. 
B is the target variable. 


A call to the RDB routine returns values in B of 65535 to 0 for good 
data. A -1 will be returned if the data is bad (defined as software 
data overrun). A -2 will be returned if there is no data. A -3 will 
be returned if a hardware data overrun occurs. 


A ring buffer is the specified buffer used by the RDB, RTS, HIST, 
PUTD, and DRS routines. Data is withdrawn from the ring buffer by the 
RDB routine but inserted into the ring buffer by the RTS, HIST, PUTD, 
or DRS routine. Two pointers which are invisible to the users point 
to the last data added and the next to be withdrawn. 


If either pointer passes beyond the buffer, it is reset to the 
beginning of the buffer. If a RDB routine is executed when no data is 
available, the pointer is not advanced. 


If a software data overrun occurs (that is, when there is no room _ in 
the ring buffer for data from the RTS, HIST, PUTD or DRS routine), 
then all subsequent calls on the RDB routine will return a -l. This 
will occur if the ring buffer is not large enough to contain all the 
data or the data is not removed from the ring buffer as fast as it is 
added. 


When the referenced buffer contains analog sampling data (RTS 
function), the values returned in B are in the range 0 to 4095 for the 
LPSl1l and 0 to 1023 for the ARI11, with the gain in the .most 
Significant bits. 


When the referenced buffer contains a clocked histogram sampling (HIST 
function), the values returned in B are in the range 0 to 65535. 
These values are either the number of ticks accumulated or the number 
remaining depending on the clock mode. 


When the referenced buffer refers to digital I/O data (DRS function), 
a value between 0 to 65535 is returned in B from the next position in 
the specified buffer. 


Example: 


Assume that the array X has 100 data values previously entered by an 
RTS routine. Print out the data making sure that data overrun did not 
occur and that 100 data points were indeed taken. 


Tm FOR Taq Th 1&e 
“EA CALE “beak, Sy 
“SA [TF Sse THEM Lom 
1a TF Ss=-1 THEM Fa 
mA TF Fe-2 THEA oA 
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GQ IF f=~% THEN 114 

PO PRINT "RING RUFFER CWERRLM, SAMPLING TOI FAST": 1 
ea Gc To 154 

GG PRINT "NO MATA AT EVENT YET": I 

198 GO To 148 

110 PRINT "HARONARE DATA OVERRUN, SAMPLING Tod FAST": I 
126 GO To 15a 

430 PRINT 2 

144 NEXT I 

158 CONTINUE 

1.68 ENE 


RE Af! 


2.4 MODULE LPS] (A/D CONVERSION AND NUMERIC READOUTS) 


2.4.1 Analog to Digital Conversion (ADC) 


The ADC routine initiates an A/D conversion from the specified 
channel, waits for it to complete, and returns the conversion as a 
floating point result in A (in the range 0 to 4095 for the LPS11l_ and 
1023 for the AR11). The A/D cannot be currently involved ina 
real-time sampling (RTS) operation. 


The form of the call is: 


CALL "ADC" (b,A[,i]) 
where 
b specifies the channel and must be in the _ range 
from 0 to 63 for LPS11 and 0 to 15 for ARI1I1. 


A is the target variable and will contain the 
floating point conversion from the analog input. 


The value returned is as follows: 


A=data/gain (where gain=1,4,16,64) For LPS11 
with gain. 

A=data When the AR11 is in 
bipolar mode. A is 
always positive. 

A=-data When the AR11 is in 
unipolar mode. A is 
always negative. 


i specifies the gain setting for the requested A/D 
conversion on an LPS11l, or the range (bipolar or 
unipolar) on an ARII. 


when 

i=0 software auto-gain ranging 

=] gain of 1 for LPS11 (-5V to +5V); bipolar 
range for AR11 (-2.5V to +2.5V), 

=2 gain of 4 for LPS11 (-1.25V to +1.24V); 


unipolar range for ARI11 (0 to +5V). 


Pe | 
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Example: 


=3 gain of 16 for LPS11 (-0.3V to +0.3V); 


illegal for ARI1l. 


=4 gain of 64 for LPS11 (-0.078V to +0.078V) ; 


illegal for ARI1l. 


The default value is l. 


NOTE 


On an LPS11, the LPSAG option must 
be present when i is not equal to 
1, otherwise the value returned in 
the target variable will be 
unspecified (i.e., dependent on 
hardware). 


Sample the A/D from channels 4 and 5, use a gain of 1, and save the 
results in arrays A4 and A5 respectively. Assume 100 samples are to 


be taken. 


LO TIM Ad¢C1OO) vAG C100) 


2O FOR Ted TO 


LOO 


SO CALL "ANC" C4yA4CT DD 
40 CALL "ANC' CS y ASC) ) 


3O NEXT Tf 


2.4.2 Real-Time Sampling (RTS) 


RTS 


The RTS routine performs real time buffered/clocked sampling of the 


A/D. 


The form of the call is: 


CALL “RTS"(A[(i)],cl,c2,n,m[,i]) 


where 
A[(i)] 


cl 


c2 


is a buffer previously defined in a call to the 
USE routine. The sampling will be stored in this 
buffer. The data pointers in the ring buffer 
will be reset before sampling is begun. 


determines the first channel to be sampled. Must 
have a value between 0 and 15 for AR11 or LPS11 
with gain other than 1 specified; or 0 to 63 for 
LPS11 with no gain or gain equal to l. This 
value must be between 0 and 7 when dual sample 
and hold is required. 


determines the number (or number of pairs) of 
sequential channels which will be sampled. The 
maximum is 16 for AR11 or LPS11l with gain other 
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than 1 specified; and 64 for LPS11 with no gain 
Or gain equal to l. 


NOTE 
The sum of Cl and C2 cannot be greater 
the 64. 
n determines the total number of samplings. 
m determines the mode of sampling. 
i specifies the gain setting for the requested A/D 


conversion. 


when 
i=0 software auto-gain ranging 
=1 gain of 1 for LPS11 (-5V to +5V); bipolar 
range for ARI11 (-2.5V to +2.5V). 
=2 gain of 4 for LPS1l1l (-1.25V to +1.25V); 
unipolar range for AR11 (0 to +5V). 
=3 gain of 16 for LPS1l1 (-0.3V to +0.3V); 
illegal for. AR11l. 
=4 gain of 64 for LPS11 (-0.078V to +0.078V) ; 


illegal for AR11. 


The default value is 1. When (cl + c2) is greater 
than 16, it is illegal for i to be equal to zero 
or greater than l. 


NOTE 


On an LPS11, the LPSAG option must be 
present when i is not equal to Il, 
otherwise the value returned in the target 
variable will be unspecified (i.e., 
dependent on hardware). 


The A/D can be enabled in a variety of modes depending on the options 
specified. The normal mode of operation (m=0) causes the A/D to 
sample whenever Schmitt trigger 1 fires for the LPS11 or external 
Start for the ARI11. To enable other options, merely add their code 
number to the mode. The following table describes options available 
(all options are normally disabled): 
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Table 2-1 
Mode Options in RTS Sampling 


Normal operation, reads on Schmitt trigger 1 for 
LPS11 or external start for ARI1. 
Enable burst mode (used only with DMA) 


Enable clock, disable Schmitt trigger 1 (used with 
LPSAD12, LPSKW or ARI1) 

Enable dual sample and hold for LPS11 only (used with 
LPSSH) 

Enable DMA for LPS11 only (used with LPSAD-NP) 





The burst mode can be used with Direct Memory Access only and the dual 
sample and hold mode can be used with the Direct Memory Access. The 
dual sample and hold, and DMA options can only be used on the LPS1l. 
The following table lists all possible values for m and the modes 
enabled. 


Table 2-2 
Mode for Values of m 


ARI11 










Schmitt trigger 1 or external start 
Clock 

Dual Sample and Schmitt trigger 1 
Dual Sample and Clock 

DMA and Schmitt trigger 1 

DMA and Burst 

DMA and Clock 

DMA and Burst 

DMA, Dual Sample, and Schmitt trigger l 
DMA, Dual Sample, and Burst 

DMA, Dual Sample, and Clock 

DMA, Dual Sample, and Burst 


nN © 





The A/D is started by a clock overflow or the firing of Schmitt 
trigger 1 (external start for AR11). Pointers are used to determine 
if data exists in the buffer arrays or if data wrap-around occurs. 
Since data is stored in circular buffers (excluding DMA operations), 
pointers are used to ensure that the incoming data rate does not 
exceed the removal rate. Data returned as -1] indicates ring buffer 
overrun; data returned as -2 indicates no data exist; data returned 
as -3 indicates hardware overrrun (interrupt service too slow). The 
buffer pointers are reset initially before the sampling operation 
begins. 


A/D channels are sampled on every clock overflow or firing of Schmitt 
trigger 1 (external start for AR11) with the result stored in 
consecutive data cells. Data is stored in a format identical to that 
read from the A/D (bits 0-11 for data and bits 11-12 for gain). When 
a clock overflow or Schmitt trigger firing occurs, the A/D samples the 
first channel specified by cl and then samples the next c2 minus 1 
consecutive channels. Sampling then continues until n clock overflows 
or Schmitt triggers have been received. If n is specified as zero, 
any previous RTS sampling will be disabled. 


In dual sample and hold mode, parameter c2 is the number of pairs of 


channels to read per’ sampling. Parameter n defines the number of 
Samplings. There are 2*C2 elements per sampling. 


2-10 
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DMA operations may use dual sample and hold. DMA allows direct 
hardware storage of A/D results from only one channel into a specified 
buffer array. A maximum of 4096 data may be taken at any one time 


with removal of data allowed only when the buffer is completely 
filled. 


NOTE 


When DMA is used with dual sample and 
hold, the parameter C2 must be 1, BASIC 
automatically assigns the value of 1 to 
C2 and any other number that is assigned 
to C2 will be ignored. 


RTS operations do not interfere with sampling operations other than 
ADC (i.e., DRS and HIST routines) and all can be in progress 
simultaneously. You must set up the clock by making a call to the 
SETR routine before calling the RTS routine. 


Example: 


Set up the A/D to read data from channels 0 through 3 and _ store _ the 
results in the array A. Schmitt triggers are to be used to fire the 
A/D. Note that a dimension of 100 allows 200 data points. Since 4 
channels are to be sampled, 50 Schmitt triggers will be required to 
complete the request. 


Lo UM a Cdao) 


we LAI “USE * OCR? 


SO CALL "RTE" Che Oe dy LOOK Yaa O) 


2.4.3 Display on the Light Emitting Diodes (LED) 


LED 


A call to the LED routine displays the floating point value of the 
specified expression on the LEDs (Light Emitting Diodes) of the LPS1l. 
Up to six positive or five negative digits can be displayed in the 
LEDs. An optional decimal point can also be included. Numbers which 
cannot be accurately displayed (i.e., E numbers or 6-digit negative 
numbers) are shown as all minus signs. 


This routine acts as a NOP (no-operation) when SAR11 is defined in 
PERPAR.MAC for an AR11l system. 


The form of the call is: 
CALL “LED" (a) 
where 


a the expression or the value to be displayed. 


Example: 
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Display the value 5.632 on the LEDs. 


a er ce as 
Lo geet, &3n 


m0 CALL SLE CAD 
or 


Pe doth. “RE tei weed 


2.4.4 Returning A/D Data from Buffer (CVSG) 
The CVSG routine returns the unformatted data value sampled by the RTS 
routine in one variable and the gain in a separate variable. A -1l 
will be returned if the data is bad (defined as overrun). A -2 will 
be returned if there is no data. A -3 will be returned when a 
hardware data overrun occurs. 
The form of the call is: 

CALL "CVSG" (V,I) 
where 


V is the target variable and contains the floating 
point conversion from the analog input in the 
range 0 to 4095 for LPS11 and 0 to 1023 for ARI11. 


I returns the gain setting of the requested A/D 

conversion. 

when 

=] gain of 1 for LPS1l1 (+o0r-5V); bipolar 
range for ARI11 (+or-2.5V). 

=2 gain of 4 for LPS11 (+or-1.25V); unipolar 
range for AR11 (0 to +5V). 

=3 gain of 16 for LPS11 (+or-.3V); illegal 
for ARI1. 

=4 gain of 64 for LPS11 (+or-.078V); illegal 
for AR11l. 


2.5 MODULE LPS2 (REAL-TIME CLOCK) 
2.5.1 Setting the Clock Rate (SETR) 


A call to the SETR routine sets the clock running in the _ specified 
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mode and at the designated rate. The interrupt enable is always set 
(except mode 8 and above). 
The form of the call is: 


CALL "“SETR"(r,m,p) 


where 
r determines the rate of the clock. 
m cletermines the mode of the clock. 
p is the preset value of the clock counter. The 


preset value must be less than 65535 (decimal) for 
the LPSKW and 255 (decimal) for the ARI]. 


The following preset values are illegal for the indicated rates in 
interrupt mode. 


Rate Illegal preset values 


1 <150 
<180 (for systems with memory management option) 


2 <5 
<18 (for system with memory management option) 


3 =] 


NOTE 
All values of rate and preset are legal in 


interrupt mode. 


The following tables describe the rates and modes determined by the 
values of r and m. 


Table 2-3 
Selecting the Clock Rate 





Values of r 


No rate selected 
i MHz 
100 kHz 
10 kHz 
1 kHz 
100 Hz . 
Schmitt trigger 1 (external event for AR11) 
Line frequency (50 Hz or 60 Hz) 


SHO PW DHE © 
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Table 2-4 
Selecting the Clock Mode 


Values of m 


Single interval mode. Counter counts from preset value _ to 
overflow and stops. 


Repeated interval mode. Counter counts from preset value to 
overflow, transfers buffer/preset register to the counter, 
and begins again. 


External event timing mode. The counter is free running, 
and a pulse from Schmitt trigger 2 transfers contents from 
the counter to the buffer/preset register and then continues 
counting. Not valid for ARI11l. 


Event timing from zero base mode is the same as mode 2 
except when the transfer of the counter to the buffer/preset 
register is done, the counter is cleared and the count 
begins from zero. Not valid for ARI11l. 


4,5,6,7 Start clock only after Schmitt trigger 1 fires. Mode is 
then determined by the value of m-4. Not valid for ARI11. 


8 to 15 Indicates the operation of the clock in a non-interrupt mode 
has been added for faster A/D data acquisition. To get the 
value of m, just add 8 to the value of the interrupt mode. 
For example: 


m=0+8 indicates single interval non-interrupt mode clock 
operation. 


m=1+8 indicates repeated interval non-interrupt mode 
clock operation. 


Example: 


Set the clock running to interrupt once every second. A 100 Hz 
frequency is used and the clock mode is l. 


CALL “SETR"(5,1,100) 
Each programmable clock interrupt causes a 16-bit software clock 
(counter) to be incremented by one. When the maximum count of 65535 


is reached, the next interrupt causes a reset to zero. This clock may 
be retrieved by the RTIM and DRS routines. 


2.5.2 Setting the Clock to Rate and Time (SETC) 


SETC 


A call to the SETC routine sets clock to specified rate and time. 
The form of the call is: 


CALL "SETC" (r,t) 
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where 


ig determines the clock rate as described in 
Table 2-3, and may be 4,5, or 7. 


t is the time in seconds that the clock runs’ before 
issuing an interrupt. 


The clock status register is set to rate determined by r and runs’ for 
t seconds. A clock interrupt then occurs which can be used to 
initiate any of the clock controlled functions. The time argument is 
evaluated as ticks equal time in seconds multiplied by the clock rate 
specified, e.g., if the clock rate was 10kHz, then ticks equal time in 


seconds multiplied by 10kHz. The ticks are entered into the clock 
preset/buffer register. The clock always runs in mode 0. 
Example: 


Set the clock to interrupt in 10 seconds using a 100 Hz frequency. 


CALL "SETC"(5,10) 


2.5.3 Histograms - Timed Schmitt Trigger (HIST) 


HIST 


The HIST routine inputs values from the clock preset/buffer register 
and stores them into the specified buffer whenever Schmitt trigger 2 
fires. The clock must be in mode 2 or 3 for the data to be 
meaningful. 


The form of the call is: 
CALL "HIST" (T[(i)],n) 
where 


T[(i)] is a buffer previously defined in a call to the 
USE routine. 


n determines the total number of data points stored. 


The RDB function is used to retrieve the data. The data pointers in 
the ring buffer are reset before the sampling operation begins. 


If n is given as zero, the HIST sampling will be disabled. 


HIST operations do not interfere with other sampling operations (i.e., 
RTS and DRS) and all can be in progress simultaneously. 


HIST routine acts aS a NOP (no-operation) when SARI11 is defined in 
PERPAR.MAC for an AR11 system. 


Example: 


Collect a timed histogram between external events (Schmitt trigger 2) 
and store the results in array T. The clock runs at 1 kHz and 100 
intervals are required. 


LO TEM Teno: 

2G CALL "USE" OT) 

S39 GALL. "HIST" (Te b00) 
4Q CALL "SETH" C49 413 
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2.5.4 Delaying Program Execution (WAIT) 





A call to WAIT disables further program execution until the specified 
event occurs. 


The form of the call is: 


CALL "WAIT" (n) 


where 
n specifies the event that must occur for program 
execution to continue. 
Values of n are: 
n=0 Wait for clock to overflow only. 
n=] Wait for Schmitt trigger 1 (external event 
for AR11) to fire (for clock rate = 6 only). 
n=2 Wait for clock to overflow or Schmitt trigger 
1 to fire. 
n>2 Returns immediately. 
n<0 Wait for Schmitt trigger 1 (external event 
for AR11) to fire (a call to the SETR or SETC 
routine must be made prior to this). 
Example: 


Wait for clock to overflow. 


10 CALL "WAIT" (0) 


2.5.5 Returning Current Software Clock Tick Value (RTIM) 


A call to the RTIM routine returns the 16-bit integer value of the 
internal software clock counter maintained by the programmable clock. 
The form of the call is: 
CALL "RTIM"(s,t) 
where 
Ss specifies whether the internal clock counter is to 
be cleared or not. The counter is cleared when s 


is equal to 0; otherwise it is unaltered. 


t is the 16-bit integer value of the internal clock 
counter. 
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2.6 MODULE LPS3 (DIGITAL I/O) 


The user should read the LPS11 Laboratory Peripheral System User's 
Guide in order to fully understand the hardware latching mechanism 
before using these modules. 


The interrupt control logic permits the LPSDR-A or the DRI1-K_ to 
perform an interrupt operation. The switches and jumpers on this 
logic can be arranged so that vector address can be assigned other 
than those configured as standard on the module for alignment. 


One method of causing interrupts to the Unibus uses the two control 
lines between the DRI1-K and the external device. If the input 
interrupt enable (bit 6 of the status register) is set, a negative 
transition (+3 v to ground) of the EXTERNAL DATA READY pulse will 
generate an interrupt to the Unibus, with a vector address of 300. A 
bus request is made on the BR level that corresponds with the level of 
the priority plug in the logic (the standard level for the DR11-K 
interface is  BR4; this may be changed on the priority plug if 
desired). The control line method of interrupting is logically ORed 
into the DR11-K interrupt control, and is disabled by internal 
clamping circuitry if not desired. The device will continue 
interrupting as long as the line is held low. 


The second and most preferred method of interrupting is to use _ the 
individual input lines. Each input (IN15:INO0O) is buffered by a 
flip-flop that will set on a negative transition (+3 v_ to ground). 
Switches for the buffered bits on the hardware option make it possible 
to wire-OR each bit onto a common interrupt line. When the input 
interrupt enable (bit 6 of the status register) is set and a switch is 
on, the transition of the associated bit causes an interrupt to the 
Unibus. The bits are read under program control by reading the input 
register, and are cleared by moving data 1s to the bits to be cleared. 
The input interrupt enable is cleared when an input interrupt is 
accepted by the Unibus; when reset, it will retrigger the interrupt 
circuit if any other input bits were set during the program service 
subroutine, so that new interrupting bits will not be lost. 


2.6.1 Reading the Digital Input Register (DIR) 


a a A LL 


A call to DIR reads the Digital Input Register and converts it to a 
floating point number. The form of the call is: 


CALL "DIR"(i,V,S[,-m[{-j]]) 
where 
i determines the type of floating point conversion. 


V is the target variable. It is the value in the 
input register ANDed with m. 


S contains the returned digital Control Status 
Register (CSR) setting. 
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m indicates the 16-bit mask. The default value is 
-l. 


5 indicates the number of the DRI1-K unit on a 
multiple DR11-K system. The default value is 0. 
The maximum legal value is determined by the 
Parameter SNUMBER in PERPAR.MAC at the assembly 
time of PERVEC.MAC module. 


If i=0, input is four Binary Coded Decimal (BCD) digits converted to a 
floating point number and the result is in the range 0 to 9999. If 
i<>0, then the binary result read from the register is directly 
converted to a floating point number and the result is in the range 0 
to 65535. The Digital Input Register is read via an internal load 
request and does not respond to interrupts. The input word is 
immediately written back into the input register to clear those bits 
which were obtained from the register. The result is returned in V. 


The new CSR register setting is returned in S. 

Example: 

1 REM THIS FROGRAM TESTS THE "YER" y "TOR" ANTO "QRS" MOTUS ALONG WITH 
2 REM SETH WAIT ANT ROB. THE TNEUT ANT THE OQUTEUT TEGITAL CABLES MUST 


P REM CONNECTED TO EACH OTHER. 
x O30) 


Ri > uM SG 
= 


oe 
& CALL "MOR" Cle S535 9N) 


? CALL "USE" (CX) 

1O FOR Tek TO 14 

=O CALL "QOR" ¢O909N) 

SQ CALL "OER" Oly Ye NI 

4Q PRINT NY 

wi Cee (ae 

SO NEXT T 

160 CALL. "TOR" Cd» SOUS 9 No 
LoS CALL "URS" Xe ly SOx»O9N) 
170 CALL "SETTER! C9 ty LOO) 
L7G Meg 

1L8O Oeg 

Les FOR Ted TO 30 

LPO CALL "TOR Cs GSS 307» ND 
LPS CALL "MOR" (Ms Q9N) 

MOO DH2OtdOo Stengel ot 

2OU CALL "WATT" ¢O) 

ZO NEXT I 

215 GUSUB BOO 

22 STOF 

SOO FOR wed TO 3oO 

SOS CALL "RIE" CX» ¥) 

SLO PRINT Jy ¥ 

S1S NEXT J 

SAO RETURN 

SOQ ENT 


RE 
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2.6.2 Writing to the Digital Output Register (DOR) 


A call to DOR can either set or clear selected bits in the Digital 
Output Register. The form of the call is 


CALL "DOR" (m,n,R[,j]) 
where 


m determines whether bits are to be set (when m=0) 
or cleared (when m is not equal to 0). 


n determines which bits are to be set or cleared. 


R contains the floating point equivalent to the new 
value in the Digital Output Register. 


5 indicates the number of tthe DR11-K unit on a 
multiple DR11-K system. The default value is 0. 
The maximum legal value is determined by the 
parameter SNUMBER in PERPAR.MAC at the assembly 
time of PERVEC.MAC module. 
If a bit in the binary representation of n is 1, the corresponding bit 
of the Digital Output Register will be cleared or set (depending on 
the value of m). If a bit in the binary representation of n is 0, the 
corresponding bit of the Digital Output Register will not be changed. 
The BASIC-11 BIN and OCT functions are very useful in setting or 
clearing the registers. 
Example: 
Turn on (set) bits 1 and 2 of the Digital Output Register. 
40 CALL "DOR"(0,BIN'110',N) Clear Digital Output Register. 
40 CALL "DOR"(1,0CT'177777' ,N) 
or 


40 CALL "DOR"(1,-1,N) 


2.6.3 Digital Readout Sampling (DRS) 


rr rt a 


A call to the DRS routine samples the Digital Input Register in a 
Similar fashion as the RTS function. 


The form of the call is: 
CALL "DRS" (A[(1)],ml,n,m2,R[,T{,m[,j]]]) 


where 
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A[(i)] is a buffer previously defined in a call to the 
USE routine. 


ml determines the mode by which the Digital Input 
Register is to be read. 

n determines the total number of samplings. 

m2 determines whether the sampling is clock driven. 

R contains the returned setting of the digital 


Control Status Register (CSR). 


T describes the address of the buffer to store the 
current clock TICK value on every data interrupt 
when m2 is not equal to zero. 


m indicates the 16-bit mask. The default value is 
-l. 
5 indicates the number of the DRI11-K unit on a 


multiple DR11-K system. The default value is 0. 
The maximum legal value is determined by the 
parameter SNUMBER in PERPAR.MAC at the assembly 
time of PERVEC.MAC module. 


When m2 is equal to 0, each time the clock fires (Schmitt trigger, or 
external event for AR11), the Digital Input Register is read. 


If ml is equal to zero the Digital Input Register will be treated as 
Binary Coded Decimal and will be converted to binary. If ml is not 
equal to zero the Digital Input Register will be input directly as a 
binary number. This number is stored in the circular buffer specified 
by A[(i)]. When DRS is first called, it resets the pointers of the 
buffer to the beginning. 


If n is given as zero, the DRS sampling will be disabled. The DRS 
call is driven by digital clock when m2 is not equal to zero. 
Whenever a new value is received in the input register, the value is 
immediately read in and stored in the buffer. The value of the 16-bit 
software clock is stored in the buffer specified by T. The input data 
word is immediately written back into the input register, and the 
active bit which have been sampled are cleared. 


The new setting of the digital Control Status Register is returned in 
R. 


Example: 


Read the Digital Input Register once every one tenth of a second for 
100 readings and store the results in array A. 


TO TIM Ata) 

29 CALL "USE" CAD 

3O CALL "URS" CAO» 1LOOvO9N) 
AQ CALL "SETR" (Sy d910) 


2-20 
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2.6.4 Relay Control (REL) 


REL 


A call to the REL routine opens or closes the specified relay. 


The REL routine acts as a NOP (no-operation) when SAR11 is defined in 
PERPAR.MAC for an AR11 system. 


The form of the call is: 


CALL "REL" (a,b) 


where 
a specifies the relay and may be equal to 1 or 2. 
b determines the operation. Relay is opened if 
equal to 0, otherwise it is closed. 
Example: 


Open relay 1 and close relay 2. 


LOO CALL "REL" Cl» O) 
LO CALL. "RIEL C29 1) 


2.6.5 Reading/Writing Data From/Into Memory (IPK) 


The IPK routine can be called to read a value from a specified address 
or place a value into a specified address. The form of the call is: 


CALL "IPK"(s,a,V) 
where 


s indicates whether the value is a word or ae byte. 
If s is even, the word value supplied in V will be 
read from or written into the even address 
register. If s is odd, the byte value supplied in 
V will be read from or written into the _ odd 
address register. 


A call such as CALL “IPK" (0,64,V) reads into 
variable V the value at location 64 in memory. 


a specifies the address where the value V is read 
from or written into. This address must be even 
when the value of s is even. This address can be 
specified as an octal string, integer constant or 
integer variable. 


A call such as CALL "IPK" (2,73,100) is illegal 
because the address is odd; the error message 
?ARG will result. 


LABORATORY PERIPHERAL SYSTEM SUPPORT 


V is the value to be read from or written into the 
address register. 
NOTE 
This routine should not be used except to 
read from or write into the I/O page or to 
read from memory. Writing into memory can 


cause serious consequences (program being 
wiped out, etc.). 


2.7 MODULE LPS4 (DISPLAY) 


The routines in this module require the LPSVC or AR11 with the VRI14 
interfaced through it. The VTll cannot be used with these routines. 


2.7.1 Defining the Display Buffer (CLRD) 


CLRD 


A call to the CLRD routine defines the display buffer having fixed 
delta x values. 


The form of the call is: 


CALL "CLRD" (A[(i)],a,b) 


where 
A[(i)] is a buffer previously defined by a call to the 
USE routine. 
a specifies the size of the buffer to be displayed. 
b specifies the scale. 
The buffer to be displayed should contain single word values. Values 


in the range 4095>=value>=0 are displayed while values outside this 
are not. The size of the buffer, a, is the number of Y points’ to 
display and must be less than or equal to the number of points defined 
in the DIM statement and the call to the USE routine. The delta x is 
calculated as 4096/a and can be fractional. 


If b, the scale, equals 0, CLRD will set all buffer values to -l 
(non-displayable values). If scale does not equal 0, CLRD bypasses 
the clearing of the array and the original data is multiplied by b. 
In either case, the PUTD pointers are reset to point to the beginning 
of the array. Data is entered into the array through the PUTD 
function; however, a CLRD must be issued before data is initially 
transferred to the array. 


A CLRD routine must be issued at least once before issuing the DIS, 
FSH, or DXY functions which can display the buffer defined by CLRD. 


Example: 
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Set up the array C to be used as a display buffer having 256 points. 
LO TIM C129) 
20 CALL "USE" C0} 
40 CALL "CLRID" (09 28690) 


2.7.2 Putting Data into Display Buffer (PUTD) 


re ere Re A A 


PUTD 


A call to the PUTD routine puts a data value into the specified 
buffer. Repeated calls to PUTD will cause the buffer to be filled 
sequentially. 


The form of the call is: 
CALL "PUTD" (A[(i)],b) 
where 
A[(i)] is a buffer previously defined by the USE routine. 


b is the value to be inserted. Must be in range 
0<=b<=65535. 


This function does not initiate a display, but rather just enters data 
into the specified array. 


Example: 


Remove 100 data points from the specified digital sampling buffer D, 
and transfer them to the buffer 2. 


BO VIM OCSO re XCGO) 
SO CALL "USE" CIly Xx) 
LOO FOR T#1 TO 100 
110 CALL "ROR" Cty XxX) 
120 CALL "PUTT (2 9X) 
130 WEXT Tf 


2.7.3 Background Display Routine (DIS) 


a enc RS 


A call to the DIS routine displays data from the buffer whenever BASIC 
is idle. Data is not displayed by DIS or DXY routines under RT-11l FB 
system because BASIC is never idle. Data is displayed under RT-1l SJ 
system (version 2 or later) only when I/O is taking place. 


The form of the call is: 
CALL "DIS"(A[(i)],a,b[,n]) where 


A[(i)] is a display buffer previously defined by the USE 
and CLRD routines. 
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determines the starting point of the display. 


determines the frequency of points in 


that are to be displayed. 
specifies the number of data 


array. 


point 


the 


to 


The points displayed start with the point a in the buffer and 


in increments 
with the a one 


of b. 
are displayed. 


is displayed, etc. 


Example: 


Display data from buffer E 
displaying every 3rd point of the remaining array elements. 


beginning at the 


2O NIM ECLOG) 

40 (ALL "USE" CIE) 

SO CALL "CLRIM CE y 20090) 

SO REM BUFFER MAY BE FALLEN HERE 


100 CALL 


"HIS" Cy Lee 3) 


P20 REM OR MAY BE FILLED HERE 


Example: 


w REM THI 
LO REM SE 


LS PRINT 


WO CALL "SETH" Cle dy 10) 


LOO DIM ACLOO) 


200 CALL, 
SOO CALL. 
Aga FOR fT 
2OO CALL 
SOQ NEXT 
7OO CALL 


YO TNFUT 


760 TNEUT 


78O CALL 


BOO INPUT 


"LISE " CA) 
"CLRID" Cay LOG9O) 


=, TO 100 


"RUT" (Ay To 


I 


"YES" Cae ty do 

1a 
"TIS" (Ay ty dy 7%) 
tN 
"SIS" (Ag dts dy SO) 
Q 


POO TF Teo TO 2000 


SO FOR iss 
Ove EC pas 


i. A ee 
1 TO SO 


POO FOR Used TO LOO 


LOGO CALL 
LOW CALL 
LORS NEXT 
LOSO NEXT 
LOW NEXT 


"FSH" Cav Sy Tet) 
"WATT" CO) 

t 

I 


gy 
a 


L1OO GO TO oOo 


2000 STOF 


12th data 


other 


point 


buffer 


display. 
The default value is all remaining elements of the 


proceed 
If b is equal to 1, consecutive points starting 


If b is equal to 2, every point 


S PROGRAM TESTS THE ROUTINES USE» CLR y PUTIN y ES y FSH ALONG 
TRy ANT Waly 
"PROGRAM TO TEST CLARY PUTS y OTS ANT FSH. " 


and 


WITH 
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2.7.4 Display Buffer (FSH) 


The FSH routine is identical to the DIS routine except that the data 
points in the buffer are completely displayed only once when this call 
is executed. The next BASIC statement is then executed. 

The form of the call is: 


CALL "FSH" (A[(i)],a,b[,n]) 


where 

A[(i)] have the 

a same 

b meaning 

n as in DIS. 
Example: 


Using the previous example, display 100 cycles of the array E. 
100 FOR Ted TO 100 


L1O0 CALL "FSH" CE» ty 3) 
120 NEXT IT 


2.7.5 Displaying X,Y Data (DxXY) 


DXY 


A call to the DXY routine displays points from two buffers as x and y 
values. These buffers are displayed whenever BASIC is idle. Data is 
displayed under RT-11 SJ system (version 2 or later) only when I/O is 
taking place. 


The form of the call is: 


CALL "DXY" (X[{(i)],Y[(j)],a,-bI[,n]) 


where 

X[{(i)] is a buffer previously defined by.a call to the 
USE routine and contains the x values. 

Y((35)] is a buffer previously defined by calls to the USE 
and CLRD routines and contains the y values. 

a determines the starting point in both buffers 

b . determines the frequency of the points in each 
buffer to be displayed. 

n specifies the number of data points to display. 
The default value is all remaining elements of the 
array. 


2225 
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The buffer containing the x values, xX[(i)] does not have to. be 
initialized by a call to CLRD, but it may be convenient to do so to 
initialize all values so that they are non-displayable. The buffer 
containing the y values must be initialized by a call to CLRD although 
the value of delta x is not used. 


As in the other display routines the a determines the location of the 
first point to be displayed in each buffer and b determines the 
frequency of points to be displayed. If b equals one, consecutive 
values are taken from the two buffers. If b equals two, every other 
value in each buffer will be used to create the display. 


Example: 


Generate fiducial marks on the display screen of a 256-point display 
every 16 points. Marks will be 10 points in height. Data will be 
generated into the arrays X and Y. 


S REM THIS PROGRAM TESTS -leS AND FXY- ROUTINES 
14 PRINT "TEST PROGRAM FOR CY AND FRY ROUTINES" 
eH DIM Medeeo, Wer se9 

2B CALL "USE" CH, 4) 

4Q CALL "CLEDU CH, 256, 

SA CALL "CLED' CY, Se, 

6@ FOR [=16 TO ¢56 STFF 16 

ra FOR J=4 TO 18 

SA CALI “PUTGM ex, D3 

9G CALL “PUTED Co D2 

148 NEXT J 

144 NEST 1 

124 CALL "GRU CRY 2) 4) 

Lea STOF 

44 ENC 


RE ACY! 


2.7.6 Flashing X-Y Data (FXY) 


FXY 


The FXY routine is the same as DXY routine except that the xX and Y 
values are displayed only once when this call is made. 


The form of the call is: 


CALL "FXY"(X[(1)],Y¥((j)],a,b[,n]) 


X[(1i)] Have the 
VC] same 

a meaning 
b as in 

n DXY. 


Example: 


a REM THIS FROGRAM TESTS -fet AMD Fet- ROUTINES 
1@ PRINT "TEST PROGRAM FOR OXY AMD FY ROUTINES" 
“A DIM ACLTSE3, YCLeeo 


38 (GALI “USE” Oma oD 
46 CALI "CLRD" CK, 2h. Go 
mals S aa | Ot Rama ek aa Me ae | 


Aa F 
Fa oF 
SA 
Ga Cf 
1 AG 
116 
Loe 
ae 
146 
4.58 
164 
17a 
18 
198 
ZAG 
a1e 
area 5) 
“34 
“4h 
“Se 
=A 


mre 


REAL 
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fk Late TO 256 STEP te 


fife Jat To 14é 

ALL "PUTo" ee, To 

Alt “PoUTE'es 73 

NFERT J 

MFRT I 

CALL "Bae ee G1. oo 
THMFUT fF 

CALL "ORY ee Sd 4. oe 
INPUT fe 

CALL "GES ee Go 1. o. BAS 
INFUT [ 

IF hPe@GO TO She 

FOF G21 TO GG 

Fok T=1. TO @ 

FOR f=. TO Lae 

CAPL "FRY Cw. Go. 1, lo 
MF ST Ts 

MEMT T 

NFRT S 

STCF 

ENT 

! 


2.8 HARDWARE REQUIRED FOR LPS COMMANDS 


The following 


Summary describes the hardware necessary 


to fully 


utilize the LPS system. 

Command Hardware Required 

USE None 

ACC None 

RDB None 

ADC LPSAD-12, LPSAM (for additional 8 channels) 

RTS LPSAD-12, LPSAD-NP (for DMA operations) 
LPSAM (for additional 8 channels) 
LPSSH (for dual sample and hold) 
LPSKW (for real-time clocking and Schmitt 
triggers) 
LPSAG-VG (for multi-gain) 

LED LPSAD-12 

CVSG None 

SETR LPSKW 

SETC LPSKW 

HIST LPSKW 

WAIT LPSKW 

RTIM LPSKW 

DIR LPSDR 

DOR LPSDR 

DRS LPSDR 

REL LPSDR 

IPK None 

CLRD None 

PUTD None 

DIS LPSVC 

FSH LPSVC 

DXY LPSVC 

FXY LPSVC 


The routines that require the AR11 are ADC, RTS, SETR, SETC, WAIT, and 


RTIM. 
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The routines that require the VR14 in addition to the AR11l are DIS, 
FSH, DXY, and FXY. 


The routines that require the DR11-K are DIR, DOR, and DRS. 


2.9 EXAMPLE PROGRAMS 


we sae 
LoR 


EM THIS FROGRAM TESTS THE "ANC" MONUIE 


2 REM IT REQUIRES 2 INPUTS? CHANNEL i AND IGAIN FROM CONSOLE 
3 REM A CHANNEL dt EQUAL TO «1. TERMINATES FROGRAM 


1Q 
2 
30 
40 
wi 
&O 
rae) 
80 
a0) 


as) 


UNFUT OC 

INFUT G 

TF (eed THEN LOO 
MALL "ANC * (lV) 
PRINT Ve ARS CY) 
CALL "ANC" Clay Vi yd) 
PRINT Viv ARS CVI) 
CALL "AX" (Cy V2» G) 
PRINT Vy ARS (V2) 
GO TO 10 


LOO ENT 


kk 


REM THIS FROGRAM TESTS THE ORS MODULE TEME LOG FEATURE 


ni 
0 
5 0 
8 0 
10 
20 
39 
40 
SO 
40 
149 
16S 
LSS 
170 
LPS 
L8O 
13S 
LQ 
LOS 
200 
210 
218 
weg 
BOQ 
FOE 
SOS 
S10 
31% 
320 
SOO 
* 
16 
“A 
a] 
cl A 
SA 


fy, £Tr 2 


= 


L 
3 YIM 2030) 
4 


IM XC3O) 
sz], 
ALL "GOR" Cle 65535 9N) 
ALL "USE" (XZ) 

FOR Tet TO 164 

(CALL "“QOR" CO»Q9N) 

CALL "CER" Cty Ye NL) 
PRINT Noy 

Qe (Ke 
NEXT 

CALL "NOR CLs 455 3% 9N) 
CALL "ORS" (Xe ly SOx leNy2y 7) 
RRCTN TT GGOGOIOIOIOK "9 Noy “ORO AOIOK KK ACK 
CALL "SETTER" C49 191) 
Mest) 

(Vee 

FOR Tst TO 30 

CALL “OR " (ly GSS 35 9N) 
CALL "DOR" (Ms O»N) 

Oe O+e2 SG 6b. 

NEXT I 

GOSUB SOO 

STOR 

FOR Jel TO 3oO 

(FALL "RUB" Xe ¥) 

CALL "RYE" C29 ¥13 
PRINT we ¥v Yd 

NEXT J 

RETURN 

ENT 


BFM THIS FROGRAM TESTS THE "RTS" AOGLLE 

REM TT REGQUIRFS = [TNFUTS: STARTING CHANNEL #. NUMEER CF CHANNELS 
REP ANG IGAIN FROM CONSOLE 

BFM A STARTING CHANNEL # FGUAL To -1 TERMINATES FROGRAM 

PIM AcSeas 


ea 

ra 

Fit 

oe 

1 Ge 
116 
124 
128 
144 
458 
168 
474 
Lee 
198 
“Aa 
#416 
ae 
ee | 
“48 
kT | 
“6a 
“ara 


“oe 


REA 
* 
Lok 
aan 
3 OR 
4K 
10 
2o 
30 
4Q) 
WO 
&O 
rae) 
80 
90 
9S 
L090 
101 
2OQ 
dQ 
2iS 
eed 


aes 
ee 


oad 


O35 


2AQ 
end 
Caw RW, 
24Q 
e729 
27 
28O 
29Q 


CALE UE 
IMFPUT S 
IF SH-41 
INF LT M 
TNFUT 
CALL 
CAL 
GOSUE: 
ga Te 
STCe 


CALL. 
TF 204 
RE TURN 
Fok [= 
GSU 
AL=2 
GOOGLE 
Ags 7 
GOSUE 
Ee? 
GES LIF 
Ad=2 
GCSE: 
AR= eS 
PRINT 
MNFRT I 
RE TLURM 
ENC: 


cr! 


EM 
iM 
iM 
kM A 
NIM AC2 
CALL. 
INFUT & 
IF Sst 
TNFUT ON 
INPUT G 
CALL 
CALL. 
GOSUEB 
GO TO 
STOF 


TH 


"R 
i 


Fk 
CALA. 
T iF %. IND on 
RE TURN 
FOR [ss 
GOSUE 
Ajs7 
Visely 
GOSUB 
Aes 
UourlJ 
GOSUEB 
AS#Z 
U3ay 
GOSUE 
Pan? 


Ly 
ANT 
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SE CAS 
THEM 456 


G 

SETR" CS, 1, Lee) 
RTS"CA, SoM. 2, 2. G? 
EE 

aD 


lame See Sat ee Nae Ss 


RDEN EA, 2 
THEN 478 


1 TO 
178 


qf 


L°a@ 


Ad, Ad, AS, Ad, AS 


{IS FROGRAM TESTS THE 
REQUIRES 3 INFUTS? 
GAIN FROM CONSOLE 


EQUAL 


"RTS" & "CVUSG" 


STARTING CHANNEL. 


STARTING CHANNEL. 
0) 


TO «1 


THEN 100 


"SETH" CS dy lOO) 


TS?’ CAvyGeNy 20929) 


ead 


0 


EMG CELE REEEECER RE BERECERRREEECRCERERECRREOEECEREECEEEEREREE 


CVSG" CZ eV) 
2 THEN 200 


Ae 


1 TO 4 


200 


2OO 


2O0 


eOO 


ROUTINES 


TERMINATES FROGRAM 
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2995 Vaal 

300 GOSUR 200 

S10 AZ 

S18 VGay 

320 PRINT AlyAZ AS A4 AS 
325 PRINT VieV2eV39V49V5 
350 NEXT I 

400 RETURN 

1000 END 

* 

1 REM THIS PROGRAM TESTS THE "RTIM" MODULE ALONG WITH SETR ANID WALT 
2 REM THE LAST 10 VALUES PRINTED WILL BE O THRO’ 9. 
10 INFUT $ 

20 IF Ga-1 THEN 1000 

30 CALL "RTIM" (Or) 

40 PRINT V 

SO CALL "SETR" (3s19100) 
60 FOR L#1 TO 10 

70 CALL "RTIM" (Le) 

80 PRINT V 

90 CALL "WAIT" CO) 

100 NEXT 

110 GO TO 10 

1000 STOF 


k 


APPENDIX A 


COMMAND SUMMARY 


The following list is a summary of the routines available for 
controlling LPS hardware and a brief description of each: 


CALL ARGUMENT LIST EFFECT 


USE (AC (i) ] [BL (j)]---C[(f£)]]) 
Defines array(s) to be used for 
storage of data. 


ACC (A[(i)]) Allows access to an entire array. 


RDB (A[(i)], B] Returns the next data point from a 
specified buffer. 


ADC (b,A[,i]) Initiates an A/D conversion on a 
specified channel and return the 
result to the user. 


RTS (A{(i)], ¢cl,c2,n,m[,i]) Performs real-time buffered/clocked 
sampling of the A/D. 


LED (a) Displays a numeric value on the 
Light Emitting Diodes. 


CVSG (V,1I) Returns the next data value = and 
gain in two separate variables. 


SETR (cr ,m,p) Sets clock running at a designated 
rate and mode. 


SETC (r,t) Sets clock running at a designated 
rate and initiates some action 
after a specified number of seconds 
have elapsed. 


HIST (T[(i)],n) Performs histogram sampling using a 
timed Schmitt trigger. 

WAIT (n) Waits for a specified event to 
occur. 

RTIM (s,t) Returns the value of the internal 
software clock counter. 

DIR (i,V,S[,m[,j]]) Reads Digital Input register. 

DOR (m,;n,R[,j]) Writes Digital Output register. 


CALL 


DRS 


REL 


IPK 


CLRD 


PUTD 


DIS 


FSH 


DXY 


FXY 


COMMAND SUMMARY 


ARGUMENT LIST 


EFFECT 


(A[(i)],ml1,n2,m2, R[,T[,m[,j]]]) 


(a,b) 


(s,a,V) 


(A[(i)],a,b) 


(A[(i)],b) 


(A[(i)], a,b[,n]) 


(A[(i)],a,b[,n]) 


(X[(i)],/-Y[(j)],a,b[,n]) 


(X{(i)]-Y0€(j)],a-b[,n]}) 


Performs sampling of the Digital 
Input register. 


Closes or opens one of two relays. 


Reads a value from a register or 
writes a value into a register. 


Defines display buffer and 
optionally clears or scales’ the 
data in it. 


Puts data into data buffer. 


Displays data with constant x. and 
variable y whenever BASIC is 
waiting for I/O. 


Displays a complete sweep of data 
with constant x and variable y. 


Displays data with variable x and y 
values whenever BASIC is waiting 
for I/O. 


Displays data with variable X and Y 
values respectively only once. 


APPENDIX B 


BUILDING LOAD MODULES 


B.1 BASIC/RT-11 


B.1.1 LPS Support 


The software supplied supports the standard hardware configuration 
only. The standard hardware configuration is determined by the 
address of the device hardware register and vectors. The standard 
LPS11 or AR11 register is at 170400 (octal) and the vector is at 340 
(octal). The standard DR11-K register is at 167770 (octal) and vector 
is at 300 (octal). 


The supplied software has to be reassembled and relinked if the 
hardware configuration does not correspond to the above. To redefine 
the hardware register and vector address, just edit the source file 
PERPAR.MAC. 


The LPS Support for BASIC/RT-11 is supplied in ten binary relocatable 
files (on DECpack disk, DECtape, floppy disk, or 9-track magtape). 
These files are: 


LPSO.OBJ Required LPS kernel module for LPS11l or 
AR11 and DR11-K 
LPS1.OBJ Optional Analog to digital conversion 
for LPS11 
ARD1.OBJ Optional Analog to digital conversion 
for AR11 and DR11-K 
LPS2.OBJ Real-time clock (60 Hz line 
frequency) for LPS11l 
ARD2.OBJ Real-time clock for AR11l (60 
One is required Hz line frequency) and DR11-K 
LPS2C.OBJ Real-time clock (50 Hz line 
frequency) for LPS11 
ARD2C.OBJ Real-time clock (50 Hz line 
frequency) for AR11 and DR11-K 
LPS3.OBJ Optional Digital input/output for LPS11l 
ARD3.OBJ Optional Digital input/output for AR11 
and DR11-K 
LPS4.0OBJ Optional Display for LPS11l or AR1l_ and 
DR11-K 
The following files are also provided in source form in all kits: 
FTBL.MAC Function Table Module 
PERVEC .MAC Vector Definition Module 
RTINT.MAC Interface Module 
PERPAR.MAC Parameter 


To build a load module BASLPS.SAV (BASIC with LPS11 support) or 


B-1 


BUILDING LOAD MODULES 


BASARD.SAV (BASIC with AR11 and DR11-K support), first transfer all 
BASIC Extensions binaries (including sources) and BASIC files to the 
system device with PIP. The parameter file PERPAR.MAC is then edited 
and assembled with FTBL.MAC, PERVEC.MAC, and RTINT.MAC. The three 
object modules produced are then linked with the LPS and BASIC object 
modules to produce a load module. 


NOTE 


All of the procedures in this section 
assume that an unaltered PERPAR.MAC is 
being edited. It is recommended that a 
copy of the original PERPAR.MAC be made 
and saved for future use. 


If the display module is not included in the LPS support to be linked, 
another background routine may be linked with BASIC, but-it must be 


defined in this module. See Section 8.8.1 of the BASIC/RT-11 Language 
Reference Manual for instructions to define the background routine. 


For the LPS routines to be accessible from the BASIC CALL statement, 
the routine must be defined in a System Function Table as described in 
Section 8.2 of the BASIC/RT-1l Language Reference Manual. FTBL.MAC is 
a function table in source’ form. If any user-written assembly 
language routines are also linked with BASIC and LPS’ software, the 
routines must be defined in this function table. See Section 8.2.1 of 


the BASIC/RT-11 Language Reference Manual for instructions to add the 


assembly language routine definitions to the Function Table. 


NOTE 


Since only one - DEVICE programmed 
request can be active, a special routine 
SDEVHD has been added to BASIC (in the 
FTBL.MAC module) to maintain a dynamic 
device list. This routine is required 
so that abnormal termination of BASIC 
(e.g., typing CTRL/C) will return the 
system to its normal state, usually by 
disabling interrupts. 


When writing new assembly language 
routines for BASIC that would normally 
use the RT-11 - DEVICE programmed 
request, use the following code instead: 


-GLOBL SDEVHD 
MOV #LIST,RO 
JSR PC,SDEVHD 


If the .DEVICE list exceeds a block of 
30 octal words, the error message "?DSP" 
will result. The size of the block can 
be changed by defining "DSPSIZ=X" in the 
PERPAR.MAC file. 


PERVEC.MAC is the vector definition module. It defines tthe hardware 
addresses of the status registers and the interrupt vectors. The 
Standard hardware address for the LPS11 and the AR11 is 170400 (octal) 
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and interrupt vector is 340 (octal). The standard hardware address 
for the LPS11 digital I/O is LPS register+1l0 (octal) and interrupt 
vector is at LPS vector+l0 (octal); for the DR11-K they are at 167770 
(octal) and 300 (octal) respectively. 


There are some LPS11 hardware systems with the interrupt vector at 
location 300 (octal). To assemble PERVEC with the interrupt vector at 
300 (octal) it is necessary to delete the semicolon before the S$vV=0 
definition in PERPAR.MAC. If the interrupt vectors are at other 
locations then correct the interrupt addresses by using the system 
editor to define $V in PERPAR equal to the interrupt address minus 300 
(octal). For example, if the LPS11 interrupt vectors start at 320 
(octal), define $V=20 (octal). 


If the registers and interrupt vector of DRI11-K are located at 
non-standard address, then OFFST1 and OFFST2 in PERPAR.MAC must be 
redefined. For example, if the register and interrupt vector 
addresses are at 167750 (octal) and 360 (octal), define OFFST1=-20 
(octal) and OFFST2=60 (octal). 


In a multiple DR11-K system there must be a difference of 10 (octal) 
between each unit in the interrupt and vector addresses. The status 
register address decreases by 10 (octal) while the vector address 
increases by 10 (octal). For example, in a 2 DR11-K system, when the 
first DRI11-K is at 167750 and 360 (octal), the second one must be at 
167740 and 370 (octal). 


PERPAR.MAC is a parameter file, a listing follows: 


TITLE PERPAR *= PERIPHERAL SUPPORT PACKAGE PARAMETER MQDULE,. 


= 


DEC*11-LBPAA=C BASIC KERNEL V0O2=01 
COPYRIGHT (C) 1974,1975 


DIGITAL EQUIPMENT CORPORATION 
MAYNARD, MASSACHUSETTS 01754 


THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO 

CHANGE WITHOUT NOTICE AND SHOULD NOT BE CONSTRUED 

AS A COMMITMENT BY DIGITAL EQUIPMENT CORPORATION. 
DIGITAL ASSUMES NO RESPONSIBILITY FOR ANY ERRORS THAT 
MAY APPEAR IN THIS DOCUMENT 


THIS SOFTWARE IS FURNISHED TO PURCHASER UNDER A 
LICENSE FOR USE ON A SINGLE COMPUTER SYSTEM AND 

CAN BE COPIED (WITH INCLUSION OF DIGITAL'S COPYRIGHT 
NOTICE) ONLY FOR USE IN SUCH SYSTEM, EXCEPT AS MAY 
OTHERWISE BE PROVIDED IN WRITING BY DIGITAL. 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE 
OR RELIABILITY OF ITS SOFTWARE ON EQUIPMENT 
WHICH IS NOT SUPPLIED BY DIGITAL. 


=e ta *e Ye we “se Ve Te Ye Ve Ye Ve “WO Ye WS Ve Ye Wo YS oO We Se XO 


THE CONDITIONALS CONTAINED IN THIS MODULE AFFECT THE ASSEMBLY 
OF THE FUNCTION TABLE MODULE "FTBL.MAC". 

TO OBTAIN THE DESIRED CONDITIONAL DEFINITION(S), 

REMOVE (USING AN EDITOR) THE 

SEMI*-COLON APPEARING BEFORE THE CONDITIONAL. 


=e Ve Ye we Ve 
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; 
*SLSI11=0 
? 
;SCAPS=0 
;SDISK=0 
elLFNDF SDISK 
SSTRNG=0 
»ENDC 
e IFDF SDISK 
SRTV2=0 
eENDC 
e LFDF SRTV2 
GVECT=354 
CONFIG=300 
; 
*DSPSIZ=X 
SDEFINE ‘X's 
eENDC 
7SLPS=0 
7;$AR11=0 
; 
~LFDF SAR11] 
S$LPS=0 
eENDC 
; 
7SDR11K=0 
; 
- IFDF SDR11K 
OFFST1=0 
OFFST2=0 
eENDC 
;DEFINE "X" EQUAL 
7 SNUMBR=X 
; 
eo LFNDF SNUMBR 
SNUMBR = j 
~ENDC 
; 
eIFDF SLPS 
7SV=0 
; 
? 
; 
; 
SADC=0 
SCLK=0 
sDIO=0 
SDIS=0 
eENDC 


TO REQUIRED SIZE OF 


TO TOTAL NUMBER OF DR11-K'S IN 
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;DEFINE FOR LSIe11 
*;DEFINE FOR CAPS=-11 SYSTEM 
*>DEFINE FOR RT=-11 


DO NOT DEFINE FOR PTS BASIC WITHOUT 
;STRINGS,= DEFINED FOR PTS VO1 WITH STRINGS 


ASSUMES RT=-11 VERSION 2 IS USED. 
7;D0 NOT DEFINE FOR RT=11 VOi="15. 
; SDISK 


*7THESE ARE DISPLACEMENTS USED FOR VERSION 2 
*DISPL. TO VT11 VECTOR IN RMON 
7DISPL. TO CONFIGURATION WORD IN RMON 


e-DEVICE LIST IN FTBL.MAC 


; SRTV2 
;DEFINE FOR LPS11 
;DEFINE FOR AR11 


; IMPLICIT DEFINITION 
7AR11 SUBSET OF LPSi1 


;DEFINE FOR DRi1K 


7THE STANDARD DR1ii*K REGISTER IS AT 167770 
*DEFINE X, WHERE OFFST1=X, FOR NON-STANDARD 
;CONFIGURATION. E.G. FOR REGISTER ADDRESS AT 
7167750 DEFINE X==-20. 

;THE STANDARD DR11=*K VECTOR IS AT 300. DEFINE 
7X, WHERE OFFST2=X FOR NON=STANDARD CONFIGURATIO 
7E.G.e. FOR VECTOR AT 330, DEFINE X=30. 


SYSTEM 


;DEFINE FOR MULTIPLE DR1i-K SYSTEM 


DEFINE FOR LPS WITH VECTORS STARTING 
AT 300. DEFAULT SETTING IS VECTORS AT 
340. SET SV = ANY OTHER DISPLACEMENT IF 
VECTORS START AT DISPLACEMENTS 
OTHER THAN O OR 40 FROM 
VECTOR 300 


™e %e Se Yo Ye We 


, INCLUDE 
* INCLUDE 
7 INCLUDE 
,; INCLUDE 
r SLPS 


A/D ROUTINES. 

CLOCK ROUTINES, 
DIGITAL IQ ROUTINES 
DISPLAY ROUTINES, 
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DEFINE FOR PLOT SUPPORT 
NO T E==SDISK MUST ALWAYS BE DEFINED FOR 
LV11 SUPPORT. 


SPLOT=0 


“=e “ee Ye “e “se 
=e te tO 


» IFDF SPLOT 


$LV11=0 ; INCLUDE LV11 SUPPORT 
$VT11=0 * INCLUDE VT11 SUPPORT 
e ENDC 7; SPLOT 
; 
?SLV11=0 ; DEFINE FOR LV11 SUPPORT 
; 
$VT11=0 7;FOR VT11 


=e to Ve WO WO 


eIFDF SVT11 


SCLOCK=0 7FOR SYSTEM CLOCK (KW11L) 
eENDC : SVT11 

; 

*SVT5S5=0 :DEFINE FOR VT55 
ekOT 


To link the LPS module with BASIC it is necessary to delete the 
semicolon (;) before $AR11 (for AR11 only), $LPS (for LPS only) and 
SDR11K (for DR11-K only) statements. If any of the four optional 
modules are not to be included, a semicolon must be inserted before 
the appropriate conditional. 


Parameter Insert semicolon before parameter if: 
SADC=0 module LPS1 or ARD1 is not to be included. 
SCLK=0 module LPS2(LPS2C) or ARD2(ARD2C) is not to be 
included. 
SDIO=0 module LPS3 or ARD3 is not to be included. 
SDIS=0 module LPS4 is not to be included. 
NOTE 


If DR11-K is used on a_e system. LPSDR 
must not be used. The total number of 
DR1I-K is defined in the PERPAR.MAC 
parameter file by SNUMBR=X, where X can 
have a maximum of 16. 


Using the system assembler, the sources are assembled in the following 
combinations to produce the needed object modules: 
Object Files Source Files 


FTBL PERPAR, FTBL 
PERVEC PERPAR, PERVEC 
RTINT PERPAR,RTINT 
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After these modules have been reassembled, the LPS support can be 
linked with the BASIC object modules with only the desired optional 
LPS modules included in the LINK command strings. 


For long programs that do not use string variables, the LPS support 
may be linked with the no string object modules BASNSR, BASNSX, and 
BASNSE. This no string version of BASIC with LPS support has more 
free core for program array storage. 


After BASLPS or BASARD has been linked, it may be loaded by the 
following monitor command: 


-R BASLPS (or BASARD) 


At this point the standard BASIC initial dialogue begins. See Chapter 


1 of the BASIC/RT-11 Language Reference Manual for a description of 
the initial dialogue. 


When editing PERPAR.MAC, S$DISK=0 should be enabled for BASIC/RT-11, 
SLPS=0 should be enabled for BASIC with LPS11 support, S$AR11=0 should 
be enabled for BASIC with AR11 support, and S$DR11K=0 for DR11-K 
support. SADC=0, S$CLK=0, S$DIO=0, and S$DIS=0 should be disabled 
whenever the appropriate optional LPS module (or AR11) is not to be 
included. For hardware address other than the standard, make changes 
as described in paragraph about PERVEC.MAC. 


The procedures for building the following load modules are described 
in this section: 


BASIC/RT-11 with complete LPS11 support 


BASIC/RT-11 with complete LPS1l1 support and LPS interrupt 
vectors at location 300 (octal). 


BASIC/RT-11 for AR11 and DR11-K (at hardware addresses’ 167750 
and 360 (octal)) support, with the ADC, DIO, CLK, 
and DIS optional modules. 


Linking instructions for both overlaying and non-overlaying versions 
are given for each. Since all editing instructions assume an original 
PERPAR.BAK, the edit back-up file, is renamed PERPAR.MAC to allow any 
future load modules to be built from an un-edited PERPAR.MAC. 


To build a load module BASLPS.SAV with complete configuration under 
RT-11 including LPS support and all four optional modules, enter the 
following command strings: 


Je OFMIT 

HERPERPAR MAC@RSE 
#£F Sh Tok =A@Qeare® 
#F; €LPS=e@aanee 
+EHOO 


.-F MACRO 

KE TALSPP REAR. FRI 
ERRORS GETPCTED: & 

FREE CORFE: tea. WORDS 


HPP RWECHPERPAR PERM C 
FRRGRGS GFTECTEI: fF 
FREF CORP: 12439 WORMS 
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HRT INTSsPP REAR, TINT 
ERRORS GETEETEM: & 
FREE CORE: 1eSeé6e WORGS 


OC 


peer LE 
HPERPAR MACHPERPRR BARR 
+: “ Cc 


The following instructions will create a BASLPS.SAV with overlaying 
which has the maximum usable area. 


oR LINK 

tRASLES, BASLPOSBASICRE, FRAP. FTL. PERVEC. RTINTAE : 46@eTeo 
TRANSFER ADMRESS = 

0 

*l PSA, LPS. LeSe, LESS. LESS 

KRAGSTI OCR AO: 1 

HRAST OHO: 1S 

RAST CHAO: 


4 


To link a non-overlaying BASLPS.SAV which will have increased 
execution speed the following commands should be given to link: 


JRL INE 

*RASLES, RASLPOSRASI CR, FRPMP. BASICE, BASICHAE: 4ha-C 
#P TRL, PERVEC. RTINTAC 

HLP GG, LSI, LESS, LPS, LeSd, BASICH 


Ad 


Complete configuration for building a load module with interrupt 
vector at location 300 (octal) - These instructions are the same as 
the preceding instructions except that a $V=0 parameter definition in 
PERPAR.MAC will be enabled. 


JR FOIT 

HE APFREAR MACOR@E 
#F; ET Sk = G@AALe@O 
#£F 7 FLESCH A@BaAlge® 
Fi; £¥= An are 

*F HO 


RF MACRO 

HF TELSPPRPAR, FPL. 
FREOQES GETFOCTFO: & 

FREE CORP: (e858 WORDS. 


HPERVECEPERFAR, PERVEC 
ERRORS DETECTED: @ 
FREF CORE: 42439 WORDS 


xRTINTSPEREAR, ETINT 
ERRORS GETFOTEO: & 
FREE CORFE: LehAd WORMS 


re ra {: 
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JR PIF 
tPERPAR MACSPR REAR RAR 
ro 8 


The following procedure can create the overlaying version. 


,F LIME 

HRAGLES, BASLESSRBASTOR, FPME. FTAL, PERVEC, RETINTCE: 4687T SS 
TEANGFFE AGGRESS = 

Gt 

HL EGG, LOL, LPSe, LPSS. | eS 

KEAASICE CO: Ler 

KRAST OHO: eC 

#tRAGSICHSO: 2 


: 


To create the non-overlaying version the following link commands 
should be given: 


JR OLINE 

HRAGLES, BASLPSS=RASTIOCR, FEM. BASICE. RASICH AE: 4aa/r 
xE TEL, PERVEC. RTINTSC 

HL PSE. LPSL. LESS. L PSE. FS4, BASICH 


oe 


Partial Configuration - To build a load module BASARD.SAV under RT-11l 
for AR11 and DR11-K support (at hardware address 167750 and 360 
(octal) which includes the ADC, DIO, CLK, and DIS routines, enter’ the 
following command strings: 


JE EDIT 

*FRPERFAR MAC@R@H 
*F; €O TSK =A@aAnre® 
Fi £AR LL = AQAALOeO 
HF; €Ok1 LE e@SaAre® 
EMBO 


Je FMT 

HFRPERVEC, MACORE® 
#F OFF ST1=6@-:-2h@® 
HF OPE ST S=6@-CEee® 
+E HE® 


JF MACRO 
#*FTRLEPERPAR, FT FL 
FREORS CFTRCTEE: & 

FREE CORF: 220854 WORKS 
PERE CSPPREAR. PR REC 
FRRORS GFTECTEO: &@ 

FREE CORF: tedez. WORDS 


+R TINTSPERPAR. TINT 
ERRORS GETECTER: @ 
FREF CORE: 12566 MORES 


ban i 


BUILDING LOAD MODULES 


SRP EP 

ePPRPAR MACHPERPAR BAKE oR 
#HPERVEC. MACSPRRYEC. BARR 
#oC 


JR LINE 

tRASAR OD, PASAROCSBASICR. FRMP. PTEL. PERVEC, RETINTCE: 460eT“C 
TRAMSPFER APGRESS = 

fic 

tLe Ce, ARDL. ARDS, ARDS, LES4 eC 

HBASICE OO: 1-C 

HRAST OR AO: tC 

*RAST CHAO: 


4 


This procedure will create an overlaying version of BASLPS.SAV. The 
following command strings may be used to link a non-overlaid version 
of BASIC with equivalent LPS support: 


JR LINE 

*HBASARCD, RASARGSRAST OCR, FRMP, BASICE,. BASICHAE: 4aaecr 
*P TRL PRERVEC. ETINT AC 

#1 PSS, ARDL, ARDS. AROS, LP Sd, BASICH 


The Laboratory Peripheral System support may also be purchased in 
source form. The following nine source files are provided in the 
BASIC Extensions package. 


LPSO.MAC 
LPS1.MAC 
LPS2.MAC 
LPS3.MAC 
LPS4.MAC 
PTBL.MAC 
PERVEC.MAC 
RTINIT.MAC 
PERPAR. MAC 


The following table lists the assembly parameters for each module: 


Source File Conditionals Define for Systems with: 


ee raters 





LPSO.MAC None 
LPS1.MAC SAR1] AR11 hardware 
LPS2.MAC cyc50 50 Hz line frequency 
(60 Hz is default) 
SAR11 AR11 hardware 
LPS3.MAC SAR11 AR11 hardware 
LPS4.MAC None 
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Source File Conditionals Define for Systems with: 
FTBL.MAC SADC LPS1 (ARD1 for AR11) 
SCLK LPS2 (ARD2 for AR11) 
SDIO LPS3 (ARD3 for AR11) 
SDIS LPS4 
SLPS SLPSO (all systems with LPS support) 
SARI11 AR11 support 
SVT11 VT1ll support 
SDISK RT-11 
SVT55 VT55 support 
PERVEC.MAC SLPS LPS11 hardware 
SV LPS (or AR11) interrupts not at location 
340 (octal) 
$VT11 VT11 support 
SARI11 AR11 hardware 
SDR11K DR11-K hardware 
SNUMBR=X Multiple (X) DR11-K hardware 
OFFST1 First DR11-K interrupt address not at 
167770 (octal) 
OFFST2 First DR11-K vector address not at 300 
(octal) 
RTINT.MAC SDIS LPS4 


The conditional $RTV2 is present in all modules to force subtitles in 
assembly listings and enable RT-11 V02 system macro processing. 


To assemble the LPS from the sources all the LPS files should be 
transferred to the system device using PIP, and then the following 
command should be given to the RT-1l1 MACRO assembler; if the line 
current is 50 Hz, the following commands should be used before calling 
MACRO: 


JROFODIT 
HEWPARAM MAC 
#T CYCSA=A 


€® 

#€F HOD 

.F MACRO 

HLPCASPR REAR, LESA (for LPS11 only - define SLPS in 
FRREORS GETECTED: &@ PERPAR.MAC -) 


FREF CORP: de2i44. WORDS 


+ LP OLSPERPAR, LES 

FREORS GETFCTED: &@ 

FREE CORE: 4498. WORKS 

HLF GS=PERPAR, Leos (for 60 Hz clock) 
FREORS GFTECTED: @ 

FREF CORP: 12452, WORKS 


HtLPSSC=PERPAR,. PARAM, LESS (for 50 Hz clock) 
ERRORS DETECTED: 
FREF CORE: 227448. WORDS 


+ PSESPPRPAR, LESS 
ERRORS METECTED: & 
FREF CORF: 12872. WORTS 
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HL PSd=PPRPAR, LPS 
FREORS GETFECTED: & 
FREE CORE: Lee@4, WORDS 


HAR =P RPAR, PSL (for AR11& DR11-K only-define 
ERRORS GFETECTEM: & SAR11& $DR11K in PERPAR.MAC) 
FREE CORFE: 11988, WORDS 


KARGOSSRPERPARS Leos (for 60 Hz clock) 
FREORS GETECTFO: & 
FREE (CCRE: 2152. MORTS 


HARMSCoPERPAR. PARAM, LESS (for 50 Hz clock) 
FRECES EMETECTED: & 
FREF CORE: ded4e. WORDS 


HARD SHPERPAR, LPoS 
RREORS DRTECTED: @ 
FREF CORF: Leare, MORES 


Ea 


Following is a listing of PERVEC.MAC which contains the interrupt 
vector location for the LPS and GT44 hardware: 


TITLE PERVEC VECTOR DEFINITION MODULE FOR BASIC SUPPORT PACKAGES, 


me we Se Te VS BVH We Ze Ve Be We WH Ws We TH Te Ts Ve We Ve Ve “We te 


we Ye Ba Ve TO VO TH TSH WE 


DEC*11-LBRPVA=B BASIC KERNEL VO2-01 
COPYRIGHT (C) 1974,1975 


DIGITAL EQUIPMENT CORPORATION 
MAYNARD, MASSACHUSETTS 01754 


THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO 
CHANGE WITHOUT NOTICE AND SHOULD NOT BE CONSTRUED 
AS A COMMITMENT BY DIGITAL EQUIPMENT CORPORATION, 
DEC ASSUMES NO RESPONSIBILITY FOR ANY ERRORS THAT 
MAY APPEAR IN THIS DOCUMENT. 


THIS SOFTWARE 1S FURNISHED TQ PURCHASER UNDER A 
LICENSE FOR USE ON A SINGLE COMPUTER SYSTEM AND 
CAN BE COPIED (WITH INCLUSION OF DEC'S COPYRIGHT 
NOTICE) ONLY FOR USE IN SUCH SYSTEM, EXCEPT AS MAY 
OTHERWISE BE PRUVIDED IN wRITING RY DEC, 


DEC ASSUMES NO RESPONSIBILITY FOR THE USE 
OR RELIABILITY OF ITS SOFTWARE ON FQUIPMENT 
WHICH LS NOT SUPPLIED BY DEC. 


THIS MODULE DEFINES THE HARDWARE ADRESSES USED BY 
SUCH HARDWARE AS THE "LPS", "ARLII", "DR1I1-K", 

THE "VT11"(GT40) AND THE "LV11". 

IF THE VECTORS FOR THESE DEVICES SHOULD CHANGE 
THIS MODULE MUST BE EDITED TO REFLECT THE CHANGE. 


DEFINE SLPS FOR LPS/AR11 SUPPORT IN PERPAR 
SAR11 FOR AR11 MODS. 
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7IF SYSTEM HAS DR1il*K, SNUMBR MUST BE DEFINED FQUAL TO TOTAL NUMBER 
rOF DR1It-K'S IN SYSTEM, 
DEFINE SDR1I1K & SNUMBR FOR DRI1=<K 


KK ROK KKK NOTE ORK KE 

IF DR1I1I*K(S) IS (ARE) PRESENT IN SYSTEM ALONG WITH THE LPS11 
THE LPSDR CANNOT BE USED, 

FORK ORR ROR RRR RRR KOK RK KEE EK 


=e te Yo Be YH ta We WS 


eIFDF SLPS 

eIFNDF SV 

$V=40 

eENDC 

~GLUBL LPSAD,LPSADB,LPSDR,LPSDMA 

eGLOBL LPSCKS,LPSPB,LPSDRS, LPSDIB 

~GLOBL LPSDOR,DRSTOF 

eGLOBL LPDISS,LPDISX,LPDISY 

~GLOBL CKLIVA,CKLIP,DRSIVA,DRSIP,LPSIVA,LPSIP 


? DEVICE EQUATES? 


LPSAD = 170400  ;LPS A/D STATUS REG. 
LPSADB = 170402 3LPS A/D RUFFER LED REG. 
LPSCKS = 170404 ;LPS CLOCK STATUS REG. 
LPSPB = 170406 ;LPS CLOCK BUFFER PRESET REG, 
eLTFNDF SARI1 
LPSDR = 170410 ;LPS DIGITAL I/O STATUS REG. 
LPSDRS = LPSDR 
LPSDIB = 170412 ;LPS DIGITAL INPUT REG. 
LPSDOR = 170414 ¢;LPS DIGITAL OUTPUT REG, 
LPDISS = 170416  ;LPS DISPLAY STATUS REG. 
LPDISX = 170420 LPS DISPLAY REG. X 
LPDISY = 170422 3LPS DISPLAY REG. Y 
eENDC 
oIFDF SAR1I1 
LPDISS = 170410 
LPDISX = 170412 
LPDISY = 170414 
eENDC 
LPSDMA = 170436 7;LPS DMA REGG, 


DEFINE "OFFST1I" IF DR11°K NOT AT STANDARD LOCATION, ALL DR11=“K'S 
MUST BE NEXT TO EACH OTHERCREGISTER ADDRESS DIFFERENCE=-"30 ONLY) 


=e "a Ve Oe 


IF DF SDRI1LK 


OFFST1=0 
LPSDR = 167770+0FFST1 
LPSDRS = LPSDR 
‘LPSDIB = 167772+0FFST1 
LPSDOR = 167774+0FFST1 
eENDC 
eIFG SNUMBR=1 
OF FST1=0 
LPSDR = 1607770+0FFST1 
LPSDRS = LPSDR 
LPSDIB- = 167772+0OFFST1 
LPSDOR = 167774+0FFST1 
eE NDC 
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? INTERRUPT VECTOR PAIRS? 


CKLIVA 
CKLIP 


e 


DRSIVA 
DRSIP 


=e “eo ws 


OFFST2=0 
DRSIVA 
DRSIP 


® 
, 


LPSIVA 
LPSIP 


TSR 

XLOC 
YLAC 
TVEC 


DPC 
DSR 
DISX 
DISY 
GTVECT 


*GTVECT: 
7GTVECT+ 
7;GTVECT+ 


LVCS 
LVDB 


“oe te VS WH Wa “SS 


DEFINE 


THE SYSTEM 


IFNDF 


se 


eENDC 


304+SV 7FADR. OF CLOCK INTERRUPT VECTOR 
306+SV ADR. OF CLOCK INT. PRIORITY 


SAR11 


310+SV ;ZADR. OF DRS INPUT INT. VECTOR 
312+SV ADR. OF DRS INPUT INT. PRIORITY. 


"OFFST2" IF DR1Iit#-K NOT AT STANDARD VECTOR LOCATION. 


e IFDF 


eENDC 


eENNC 


el FDF 
» GLOBL 


~GLOBL 


HUH 


43 
103 
eENDC 


e TFDE 
6 GLOBL 


eENDC 


eGLOBL 


SDR11K 


300+0FFST2 
302+0FFST2 


300+SV  f;ADR. OF THE A/D INT. VECTOR. 
302+SV  ;ADR. CF THE INT.PRIORITY. 


* SLPS 

STABLT *PROTOTYPE WRITING TABLET 
TSR, TINT, TVEC,XLOC,YLOC 

164040 *WRITING TABLET CSR 

TSR+2 7X LOCATION OF TURTLE 
XLOC+2 7Y¥ LOCATION OF TURTLE 

270 INTERRUPT VECTOR 


SVT11 7GT40 
DPC,DSR,DISX,DISY,GTVECT 


172000 ¢;VT11 DISPLAY PC 

DPC+2 7VT11 DISPLAY STATUS REG 

DSR+2 7;VT11 X STATUS REG 

DISX+2  ;VT11 Y STATUS REG 

320 7ADRe OF VT11 (GT40 (GT44)] INTERRUPT 
sVECTOR LIST. REDEFINING GTVECT 
?7REDEFINES THE ENTIRE SET 
7OF DISPLAY PROCESSOR INT. VECTORS, 
?DISPLAY STOP VECTOR 
7;LIGHT PEN HIT VECTOR 
?DISPLAY TIME OUT VECTOR 

; SVT11 


SLV11 * LVil SUPPORT 
LVCS,1LVO0B 


177514 ¢ LV11 STATUS REGISTER 
LVCS+2 3 LV11 DATA BUFFER 


THE FOLLOWING ARE GLOBAL CONSTANTS WHICH ARE REDEFINED BASED ON 
CONFIGURATION(LIKE LPS/AR11 ETC.). 


$LP511,$LPS12,$SLPS513 7FOR LPS MODULE 
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SLPS11: 


$LPS13= 


SLPS13= 


SLPS12:5 


e 
, 


SLPS21: 


e 
’ 


SLPS31: 


; 
SLPS32: 


° 
’ 


SLPS413 
SLPS423 
SLPS43: 
SLPS443 


SLPS41°8 
SLPS425 
SLPS433 
SLPS445 


=e “0 


DRSON? 


» LFNDF 
«WORD 
6000 
eENDC 
IFDEF 
«WORD 
1000 
eENDC 


e TFNDF 
eWORD 
e WORD 
eENDC 
ol FDF 
«WORD 
e WORD 
eENDC 


s GLOBI, 


e IFNDE 
e WORD 
e lFDF 
e WORD 
eK NDC 


» GLOBL 


e WORD 
«WORD 
e WORD 


-GLOBL 
477777 
177777 


eGLOBL 
e IFNDF 
e WORD 
«WORD 
e WORD 
» WORD 
eENDC 
eITFDF 
e WORD 
«WORD 
«WORD 
e WORD 
eENDC 


eGLOBL 


eWVORD 
eWORD 
«WORD 
eWORD 
e WORD 
e WORD 
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SAR11 
77,4 


S$AR11 
17,2 


SAR11 
77,100 
177777,17,4 


SAR11 
17,20 
177777,2,2 
SLPS21 


SAR11 
7,17,177777 


SAR11 
7,111,377 


7LPS 
777=63.=CHAN, 4=IGAIN 
7FOR AUTO*@GAIN RANGE CHECKING 


7LPS 
777=63.=CHAN, 100=64,=NSC 
7177777=65535,=NPTS, 17=15.=MODE, 4=IGAIN 


,;AR11 
317=15.=CHAN, 202=16.=NSC 
3177777=65535.=NPTS, 2=MODE, 2=IGAIN 
sFOR LPS2 MODULE 


?LPS 
,7SRATE, 17=15.=MODE, 177777=65535,=PRESET 


FAR11 
;7=RATE, 11=9.=MQODE, 377=255,.=PRESET 


$LPS31 ;FOR LPS3 MODULE 


177777 7177777=65535.=N 
177777 *177777=65535.=MASK 
SNUMBR=1 *7NUMBER OF DR11°K'S IN SYSTEM, DEFAULT=1 
SLPS32 
7177777=65535.=SW 
7177777=65535.=VAR(WRITE) 
$LPS41,SLPS42,SLPS43,SLPS44 rFFOR LPS4 MODULE 
SAR11 7LPS 
10000 ?10000=4096.=XMAX/YMAX 
7777 77777=4095.=N 
7777 *7777=4095,=1 
177777 #177777=65535.=NP 
SAR11 rAR1I1 
2000 72000=1024.=XMAX/YMAX 
1777 71777=1023.=N 
1777 71777=1023.=1 
177777 #177777=65535.=NP 


DRSON,DRSTOF 


oocooc ce 


*DIGITAL I/70 STORAGE VARIES WITR 
*TOTAL NUMBER OF DR1i1=K'S IN SYSTEM 


*;DRSON?08 DRS OPERATION IN PROGRESS 
?BCDON: 28 BCD/BINARY SWITCH 

?DRSBUF S45 DRS BUFFER DESCRIPTOR ADD. 
*DRSNPT263 DRS NUMBER OF POINTS 
*MASK3108 DRS MASK FOR INPUT 

*DRTBUF 3123 DRS TIME BUFFER DESC. 
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g 
eIFG 
«WORD 
«WORD 
«WORD 
«WORD 
«WORD 
eWORD 
eENDC 
eIFG 
«WORD 
«WORD 
e WORD 
«WORD 
eWORD 
WORD 
eENDC 
eIFG 
e WORD 
» WORD 
»WORD 
«WORD 
«WORD 
e WORD 
eENDC 
eIFG 
e WORD 
«WORD 
«WORD 
»WORD 
«WORD 
«WORD 
eENDC 
eIFG 
«WORD 
e WORD 
«WORD 
«WORD 
»WORD 
«WORD 
eENDC 
elFG 
eWORD 
» WORD 
» WORD 
e WORD 
»WORD 
e WORD 
eENDC 
eIFG 
e WORD 
«WORD 
e WORD 
«WORD 
eWORD 
WORD 
eENDC 
eIFG 
WORD 
e WORD 
«WORD 
»WORD 
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SNUMBR@=1 


occocoeo 


SNUMBR2 


ooocococ 


SNUMBR#3 


coococo 


SNUMBR=4 


oococoo 


SNUMBR"5 


ooocco 


SNUMBR=6 


oocoooco°o 


SNUMBR=7 


oooccoo 


SNUMBR=10 
0 


0 
0 
0) 


*DRSON?02 
?BCDONS 23 
;DRSBUF 248 
*;DRSNPT:63 
*MASK23103 
*DRTBUF S123 


;DRSON: 08 
sBCDON:2: 
*DRSBUF 348 
7DRSNPT368 
sMASK:108 
SDRTBUF 3128 


7;DRSON3 08 
?;BCDONS 23 
7;DRSBUF 343 
;DRSNPT363 
;MASK3108 
;DRTBUF S123 


7;DRSON: 03 
;BCDON: 2: 
sDRSBUF 343 
7DRSNPT 3:68 
;MASK3:103 
*DRTBUF 312: 


*DRSON:03 
SBCDON3: 23 
sDRSBUF 343 
sDRSNPT 368 
sMASK3108 
sDRTBUF 312: 


;DRSONSO38 
*BCDON3: 2: 
;DRSBUF 3:43 
*PRSNPT363 
7MASK310¢8 
;DRTBUF 3128 


SDRSON3O8 
SBCDONS 28 
SDRSBUF 34s 
sDRSNPT363 
*MASK32108 
sDRTBUF 312: 


rDRSON? O38 
;BCDONS 28 
;DRSBUF S43 
rDRSNPT S63 
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DRS OPERATIUN IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD, 
DRS NUMBER OF POINTS 

DPS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC, 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


DRS OPERATION JN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD, 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC, 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD, 
DKS NUMBER OF POINTS 

DPS MASK FOR INPUT 

DRS TIME BUFFER DESC, 


DRS OPEKATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCKIPTOR ADD. 
DRS NUMBER CF POINTS 
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e WORD 0 PMASK3102 DRS MASK FOR INPUT 

«WORD 0 FORTBUF S123 DRS TIME BUFFER DESC. 
eENDC 

e1lFG SNUMBR=11 

eWORD 0 PDRSON: O08 DRS OPERATION IN PROGRESS 
2 WORD 0 *BCDONS 28 BCD/BINARY SWITCH 

e WORD Q ?DRSBUF 343% DRS BUFFER DESCRIPTOR ADD. 
» WORD Q ?DRSNPT 363 DRS NUMBER OF POINTS 

e WORD 0 *MASK2103 DRS MASK FOR INPUT 

e WORD 0 ?;DRTBUF #212: DRS TIME BUFFER DESC. 
eENDC 

elFG SNUMBR=12 

«WORD 0 PFORSON3 08 DRS OPERATION IN PROGRESS 
«WORD 0 ?BCDONS 23 BCD/BINARY SWITCH 

» WORD Q *;DRSBUF 3 438 DRS BUFFER DESCRIPTOR ADD, 
e WORD 0 ?DRSNPT 368 DRS NUMBER OF POINTS 

eWORD 0 ;MASK3108 DRS MASK FOR INPUT 

» WORD 0 ?DRTBUF 2123 DRS TIME BUFFER DESC. 
eENDC 

o LFG SNUMBR=1 3 

«WORD 0 *DRSONSO$ DRS OPERATION IN PROGRESS 
«WORD 0 PBCDON: 22 BCD/BINARY SWITCH 

e WORD 0 ?DRSBUF:43 DRS BUFFER DESCRIPTOR ADO, 
e WORD 0 ;DRSNPT 263 DRS NUMBER OF POINTS 

«WORD 0 *MASK3103 DRS MASK FOR INPUT 

«WORD 0 *DRTBUF 3128 DKS TIME BUFFER DESC. 

eITFG SNUMBR#=14 

eWORD 0 ;DRSON308 DRS OPERATION IN PROGRESS 
e WORD 0 *BCDONS 235 BCD/BINARY SWITCH 

«WORD 0 *;DRSBUF 243 DRS BUFFER DESCRIPTOR ADD, 
«WORD 0 *DRSNPT 363 DRS NUMBER OF POINTS 

«WORD 0 *MASK3108 DRS MASK FOR INPUT 

e WORD 0 *DRTBUF 312: DRS TIME BUFFER DESC. 
«ENDC 

eI FG SNUMBR#15 

«WORD 0 *;DRSONS03 DRS OPERATION IN PRGGRESS 
» WORD 0 *BCDONS 23 BCD/BINARY SWITCH 

» WORD 0 7;DRSBUF 343 DRS BUFFER DESCRIPTOR ADD. 
e WORD Q *;DRSNPT 362 DRS NUMBER OF POINTS 

e WORD 0 *MASK3108 DRS MASK FOR INPUT 

«WORD 0 *DRTBUF 2123 DRS TIME BUFFER DESC, 
eENDC 


e END 


B.2 BASIC/CAPS-11 


B.2.1 LPS Support 


The Laboratory Peripheral System (LPS) support for BASIC is’ supplied 
in ten binary files. 


LPSO.OBJ Required LPS kernel module for LPS11 or 
AR11 and DR11-K. 

LPS1.OBJ Optional Analog to digital conversion 
for LPS11l. 

ARD1.OBJ Optional Analog to digital conversion 


for AR11 and DR11-K. 
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LPS2.OBJ Real-time clock (60 Hz line 
frequency) for LPS1l. 

ARD2.OBJ Real-time clock (60 Hz line 

One is required frequency) for AR11 and 

DR11-K. 

LPS2C.OBJ Real-time clock (50 Hz _ Iline 
frequency) for LPS1ll. 

ARD2C.OBJ Real-time clock (50 Hz line 
frequency) for ARI1 and 
DR11-K. 

LPS3.OBJ Optional Digital input/output for 
LPS11l. 

ARD3.OBJ Optional Digital input/output for ARI11 
and DR11-K. 

LPS4.OBJ Optional Display for LPS1l1 or AR11 and 
DR11-K. 


The standard BASIC/CAPS binary kit contains all the object modules 
required to link a version of BASIC/CAPS that contains LPS support 
(with all four optional LPS modules). 


There are also the following files which are provided in source form 
in all kits: 


FTBL. PAL Function Table Module 
PERVEC. PAL Vector Definition Module 
BASINT. PAL Interface Module 
PERPAR. PAL Parameter file 

NOTE 


BASIC with LPS support requires a PDP-11l 
with 16K or more of memory. The 
procedures in this section assume the 
user has at least 16K of memory and has 
reconfigured his CAPS-1ll system, along 
with PAL and LINK, for 16K. 


To create a version of BASIC/CAPS with complete LPS support, no GT 
support, and a standard hardware configuration, it is only necessary 
to link the supplied object modules. 


To create a customized version of BASIC/CAPS with LPS support, the 
parameter file PERPAR.PAL is edited and assembled with FTBL.PAL, 
PERVEC.PAL and BASINT. The three object modules produced are then 
linked with the LPS and BASIC object modules to produce a load module. 


NOTE 


All of the procedures in this section 
assume that an unaltered PERPAR.PAL is 
being edited. It is recommended that a 
copy of the original PERPAR.PAL be made 
and saved for future use. 
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The BASINT.PAL interface module should be used with all versions of 
BASIC/CAPS. If the display module is not included in the LPS support 
to be linked, another background routine may be linked with BASIC but 
it must be defined in this module. 


For the LPS routines to be accessible from the BASIC CALL statement, 
the routine must be defined in a System Function Table. FTBL.PAL is a 
function table in source form. If any user-written assembly language 
routines are also linked with BASIC the routines must be defined in 
this function table. 


PERVEC.PAL is the vector definition module. It defines the hardware 
addresses of the status registers and the interrupt vectors. The 
standard hardware address for the LPS (or AR11) interrupt vector is 
340 (octal). In PDP-11E10 machines with LPS (or AR11) support, 
however, the interrupt vector is location 300 (octal). To assemble 
PERVEC with the interrupt vector at 300 (octal) it is necessary to 
delete the semicolon before the S$V=0 definition in PERPAR.PAL. If the 
interrupt locations are at another location in memory, correct the 
interrupt addresses by using the system editor to define $V in PERPAR 
equal to the interrupt address minus 300 (octal). For example, if the 
LPS (or AR11) interrupt vectors start at 320 (octal) define SV=20 
(octal). A listing of PERVEC.PAL is printed at the end of section 
B.1.2. To link the LPS (or AR11) module with BASIC it is necessary to 
delete the semicolon (;) before the S$LPS=0 (or SAR11=0) statement in 
PERPAR.PAL. If any of the four optional modules are not to be 
included, a semicolon (;) must be inserted before the appropriate 
conditional. 


Parameter Insert ; before parameter if 
SADC=0 module LPS1 or ARD1 is not to be included. 
SCLK=0 module LPS2 (LPS2C) or ARD2 (ARD2C) is not to be 
included. 
$DIO=0 module LPS3 or ARD3 is not to be included. 
SDIS=0 module LPS4 is not to be included. 


Using the system assembler PAL, the sources are assembled in the 
following combinations to produce the needed LPS object modules: 


Object File Source Files 
FTBL PERPAR, FTBL 
PERVEC PERPAR, PERVEC 
BASINT PERPAR, BASINT 


After these modules have been assembled, the LPS support may be linked 
with the BASIC object modules with only the desired optional LPS 
modules included in the LINK command strings. 


After BASLPS has been linked it may be loaded by the following monitor 
command: 


»-R BASLPS 


At this point the standard BASIC initial dialogue occurs. 
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As part of the initial dialogue, BASIC prints: 
USER FNS LOADED 
This message occurs whenever BASIC has been linked with LPS support. 


When editing PERPAR.PAL, SLPS=0 should be enabled for BASIC with any 
LPS support (or S$AR11 for AR11l support), and SADC=0, SCLK=0, SDIO=0, 
and S$DIS=0 should be disabled whenever the appropriate optional LPS 
module is not to be included. In addition, $V=0 should be enabled for 
any PDP-1l1 with LPS (or ARI11) hardware interrupt located at 300 
(octal) instead of 340 (octal). Most PDP-11E10 with LPS (or ARI11) 
require the defining of the $V=0 assembly parameter. For hardware 
addresses other than 300 or 340, define SV as described in paragraph 
about PERVEC.PAL. Linking BASIC/CAPS with LPS Support 


The procedures for building the following load modules are described 
below: 


BASIC/CAPS with complete LPS support. 

BASIC/CAPS with complete LPS support and LPS interrupt 
vectors at location 300 (octal). 

BASIC/CAPS with only the ADC and ODIS_ optional display 
modules. 


Since all editing instructions assume an original PERPAR.PAL, a _ copy 
of the original file should be preserved to allow any future load 
modules to be built from an unedited PERPAR.PAL. 


In all the following examples the user can substitute the module LPS2C 
for the module LPS2 if the line frequency is 50 Hz instead of 60 Hz. 


Complete Configuration 


To build a load module BASLPS.SLO under CAPS-11 including LPS support 
and all four optional modules, enter the following command strings: 


(MOUNT A SCRATCH CASSETTE ON DRIVE 1) 


+Z 1? 
(TYPE <CR>) 
ry aa 
(MOUNT A SECCOND SCRATCH CASSETTE ON DRIVE 1) 
R EDL 
KEWL IFERFAR . LFS@® 
(WHEN CASSETTE ON DRIVE 0 REWINDS, MOUNT 
CASSETEE CONTAINING PERPAR.PAL ON DRIVE 0) 
XEROSFERFAR « FAL@RDD 
KE FS CAF S=QOAL@D 
KE § $LFS=OOAL@D\ 
KEX$% 


oR FALLS 


KOUR TRL ORJ/Pe1 TPERPAR. LE S/F» FTBL «PAL /F 
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FASS 2 
O? 
1? 
1? 


000000 ERRORS 


KXOTPERVEC OBJ@1 °F ERFAR. LP S/F sPERVEC. FAL /F 


1? 


i? 

1? 

000000 ERRORS 
1? 

L? 

FASS 2 

1? 

1? 


000000 ERRORS 


x~C 
(Mount CAPS-1l1 system cassette on unit 0) 
(Mount scratch cassette on unit 1) 
(Mount BASIC object module cassette containing 
BASICR. OBJ 
on unit 1) 

eR LINK 


(When unit O has rewound, mount zeroed scratch 
cassette 
on unit 0) 


X13 BASLFS.SLOeyLP t=O; RAST CR oF PMF »y BRASTCE »y BASTICX»s BASTCS/B? 4400/0 
»FTRL/F ey PERVEC » RASINT 9 LP SO/F ey LPSd LPS 2» LPSSyLPS4» RASTCH/F 


QO? (Mount cassette with FTBL.OBJ on unit 0) 
oO? (Mount cassette with LPSO.OBJ on unit 0) 
Oo? (LOAD MAP PRINTED) 


FASS 2 


QO? (Mount cassette with FTBL.OBJ on unit 0) 
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OF (Mount cassette with LPSO.OBJ on unit 0) 

O? (Mount cassette with BASICH.OBJ on unit 0) 

KOR (Done. Cassette on unit 0 contains a new 
BASLPS.SLO 
which is BASIC/CAPS plus all LPS support-interrupt 
vectors 


at 340 (octal)). 


Complete Configuration 
Interrupt vectors at location 300 (octal) 


These instructions are the same as the preceding instructions 
except that a $V=0 parameter definition in PERPAR.PAL is 
enabled. 

To change the interrupt vector location, the file PERPAR.PAL 
must be edited to enable the $V=0 parameter definition. The 
new PERPAR is then used to reassemble PERVEC.PAL to 

redefine the vector locations. 


G) represents the ALTMODE key 
(Mount CAPS-11 system cassette on unit 0) 
(Mount scratch cassette on unit 1) 


Zz 13 

(Mount a second scratch cassette on unit 1) 
+Z 13 
oR EDIT 


XEWLIFERFAR . LE S@@ 
(Mount BASIC object cassette containing PERPAR. PAL 
on unit 0) 

KEROSPERFAR « PAL@RQD 

KF F SCARS = OO ALOD® 

KF SLES= OO ALD 

KF § $V=0@O AL 

KIX 
(Mount CAPS-11 system cassette on unit 0) 


eR FALLS 


XE TRL ZB 1S PERPAR SLES ZF » FT RL 6 PAL ZF 


ie (Type any keyboard character) 

1? (Mount cassette with FTBL.PAL on unit 1) 

FASS 2 

OF (Mount second scratch cassette on unit 0) 

1? (Mount cassette with new PERPAR.PAL on unit 1) 
1? (Mount cassette with FTBL.PAL on unit 1) 


O90000 ERRORS 


XPERVECSLIPERPAR. LES/ZPy PERVEC . RAL ZF 
1? (Mount cassette with PERPAR.LPS on unit 1) 
1? (Mount cassette with PERVEC.PAL on unit 1) 
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FASS 2 
1? (Mount cassette with PERPAR.LPS on unit 1) 
1? (Mount cassette with PERVEC.PAL on unit 1) 


(Now the cassette on unit 0 has a new PERVEC.OBJ) 
000000 ERRORS 


XBASINT= 1 7 PERFPAR.LES/P» BASINT. FAL /F 


L? (Mount cassette with PERPAR.LPS on unit 1) 

7 (Mount cassette with BASINT.PAL on unit 1) 
(Cassette on unit 0 now contains a new BASINT.OBJ) 

FASS 2 

1? (Mount cassette with PERPAR.LPS on unit 1) 

i-© (Cassette on unit 0 now contains a new BASINT.OBJ) 


000000 ERRORS 


xo C 
(Mount CAPS-11 system cassette on unit 0) 
(Mount cassette containing BASICR.OBJ on unit 1) 


eR LINK 
(When unit 0 has rewound, mount cassette with new 
PERPAR.PAL on unit 1) 


(Mount cassette with BASICR.OBJ on unit 0) 


KLE BASLES .-SLOeLPS=BASTCRy PPMP s RASTIOCE » RASTICXs BASTCS/ RY 400/0 
FT BL/ZP oe PERVEC »y BRAS INTs LESO/Py LE Sd eLES2y LP SS ey LPS4y RAST CHF 


Oo? (Mount cassette with new FTBL.OBJ on unit 0) 
oO? (Mount cassette with LPSO.OBJ on unit 0) 
OF (Mount cassette with BASICH.OBJ on unit 0) 
(LOAD MAP PRINTED) 
FASS 2 
Oo? (Mount cassette with new FTBL.OBJ on unit 0) 
OQ? (Mount cassette with LPSO.OBJ on unit 0) 
0? (Mount cassette with BASICH.OBJ on unit 0) 
ae Be (Done. New version of BASLPS.SLO with LPS 


interrupt vectors at 300 is on cassette 1) 


Partial Configuration 


To build a load module BASLPS.SLO of BASIC/CAPS which includes only 
the ADC and display routines, enter the following command strings: 


(Mount CAPS-11 system cassette on unit 0) 
(Mount scratch cassette on unit 1) 
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02 18 
(Mount second scratch cassette on unit 1) 
ei 18 


ek EQIT 

KEWL SPERFP AR. LE SB 

KEROSPERFAR . FAL@RGD 

KEROTPERE AR. FP ALGEOD 

KF SS CAPS= ODOALBD 

KFS BLES = ODO ALCP 

KFS CLAN ODA T BO 

KF SOL O=ODOA tt 

KE XB ‘ 
(Mcunt CAPS-11 system cassette on unit 0) 


For AR11 support, enter the following command strings after mounting 
second scratch cassette on unit lL: 


oR FALAG 


KFT RL / Ped SRPERPAR. LE S/F» FT BL. PAL ZF 
1? (Type any keyboard character) 
1? (Mount cassette with FTBL.PAL on unit 1) 


OF (Mount second scratch cassette on unit 0) 
1? (Mount cassette with new PERPAR.PAL on unit 1) 
1? (Mount cassette with FTBL.PAL on unit 1) 


000000 ERRORS 
(Cassette on unit 0 now contains a new FTBLL.OBJ) 


XPERVEC RL IPERPAR. LE S/F yPERVEC. FAL AF 
L'? (Mount cassette with PERPAR.LUPS on unit 1) 
1? (Mount cassette with PERVEC.PAL on unit 1) 


FASS 2 
Le (Mount cassette with PERPAR.LPS on unit 1) 
ACF (Mount casset with PERVEC.PAL on unit 1) 
(Now the cassette on unit 0 has a new PERVEC.OBJ) 
9900000 ERRORS 
KEASINT= 1. TPERFPAR.LES/F » BAS INT. FAL SF 
1? (Mount cassette with PERPAR.LPS on unit 1) 


Le (Mcunt cassette with BASINT.PAL on unit 1) 
(Cassette on unit 0 now contains a new BASINT.OBJ) 
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000000 ERRORS 


(Mount CAPS-11 system cassette on unit 0) (Mount 
cassette containing BASICR.OBJ on unit 1) 

ok LOINK 
(When unit 0 has rewound, mount cassette 
containing new PERPAR.PAL on unit 0) 


KIS BASLES.SLOeLPS = BASTICRe FEMP y BASTCE s BASICXs HASICS/ ES 400/70 


gP TRL Pe RERVEC y RAS INT y LE SOE y LESH sy LPS4» RASTCH/E 

Oo? (Mount cassette with new FTBL.OBJ on unit 0) 

or (Mount cassette with LPSO.OBJ on unit 0) 

QO? (Mount cassette with BASICH.OBJ on unit 0) 

rASS 2 (LOAD MAP PRINTED) 

QO? (Mount cassette with new FTBL.OBJ on unit 0) 

QO? (Mount cassette with LPSO.OBJ on unit 0) 

O? (Mount cassette with BASICH.OBJ on unit 0) 

KC (Done. WNew version of BASLPS.SLO with only ADC 
and display routines, interrupt vectors at 340, is 

* on cassette 1) 


Assembling LPS, AR11 Support from the Sources 


The Laboratory Peripheral System support may also be purchased in 
source form. The following nine source files are provided. (The 
source files for FTBL, BASINT, PERPAR, and PERVEC are provided with 
the binary kit.) 


LPSO.PAL 
LPS1.PAL 
LPS2. PAL 
LPS3.PAL 
LPS4.PAL 
FTBL. PAL 
PERVEC. PAL 
BASINT. PAL 
PERPAR. PAL 
The following table lists the assembly parameters for each module: 


Source File Conditionals Define for Systems with: 
LPSO. PAL None 


LPS1. PAL SAR11 ARI1I1 hardware 
SCAPS PTS hardware 
LPS2. PAL CYC50 50 Hz line frequency 
(60 Hz is default) 
SARI1 AR11 hardware 
SCAPS PTS hardware 
LPS3.PAL SARI1I1 AR11 hardware 
LPS4.PAL None 
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Source File Conditionals 


FTBL. PAL SADC 
SCLK 
SDIO 
SDIS 
SLPS 
SAR11 
SVT11 
SDISK 
SVT55 
PERVEC. PAL SLPS 
SV 


SVT11 
SAR11 
SDR11K 
SNUMBR=X 
OFFST1 


OFFST2 


BASINT. PAL SDIS 


Define for Systems with: 


LPS1 (ARD1 for AR11) 

LPS2 (ARD2 for ARI11) 

LPS3 (ARD3 for AR11) 

LPS4 

SLPSO (all systems with LPS support) 
AR11 support 

VT1l support 

RT-11 

VT55 support 


LPS11 hardware 
LPS interrupts 
(octal) 

VT11l support 
AR11 hardware 
DR11-K hardware 
Multiple (X) DR11-K hardware 
First DR11-K interrupt address 
167770 (octal) 

First DR11-K vector address not at 
(octal) 


not at location 340 


not at 


300 


LPS4 


To assemble the LPS object modules from the sources, use the following 


command strings: 


eh BELT 

XEW LIP ARAM» PAL@® 
K TOYO Os 

Ch) 

XE BD 


oR PALI 


XLILP SO. ORO PERPAR. LES/Py LP SO. PAL AF 


Gr? 


ae 


FASS 2 


Or 


Or 


QOO000 ERRORS 


KIEL PS OREO SPERP AR. LPS Fy LP Sd. PAL AF 


Or 


ar? 


(Mount cassette with 
PERPAR.PAL on unit 0) 

(Mount cassette with LPSO.PAL 
on unit 0) 

(Mount cassette with 
PERPAR.PAL on unit 0) 

(Mount cassette with LPSO.PAL 
on unit 0) 

(Mount cassette with 
PERPAR.PAL on unit 0) 

(Mount cassette with LPS1.PAL 


on unit 0) 
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PASS 2 


LOAD MODULES 


OF (Mount cassette with 
PERPAR.PAL on unit 0) 

QO? (Mount cassette with LPS1.PAL 
on unit Q) 

GO0000 ERRORS 

KIL S2. OREO 2 PE RFPAR. LES/P ey LPS. PAL ZF 

OF (Mount cassette with 
PERPAR.PAL on unit 0) 

Oe? (Mount cassette with LPS2.PAL 
on unit 0) 

FASS 2 

Qi (Mount cassette with 
PERPAR.PAL on unit 0) 

GO? (Mount cassette with LPS2.PAL 
on unit 0) 

OOO00O ERRORS 

For line frequency of 50 Hz, use LPS2C instead of LPS2. 

KL ELE S20. OREO e PERE Ar LPS ZB PARAM. PALF LPS. Pal “FP 

Oo? (Mount cassette with 
PERPAR.PAL and PARAM.PAL on 
unit Q) 

ae (Mount cassette with LPS2.PAL 
on unit 0) 

FASS 2 

Oe? (Mount cassette with 
PERPAR.PAL and PARAM.PAL on 
unit 0) 

Oe (Mount cassette with LPS2.PAL 
on unit 0) 

OOGOOO ERRORS 

K1LILPSS OBJ OFPERPAR. LES/P ey LESS. PAL ZF 

(ye (Mount cassette with 
PERPAR.PAL on unit 0) 

OF (Mount cassette with LPS3.PAL 
on unit 0) 

FASS 2 

ar (Mount cassette with 


PERPAR.PAL on unit 0) 
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OP 


OO0000 ERRORS 


KIL PSA OR EOC PERPAR. LE S/F y LP S4. PAL ZF 


Or? 


QO? 


FASS 2 


wi? We 


Or? 


Oo? 


000000 ERRORS 


For AR11 support, 


KL ARTO. OR JERPERFPAR. ARTF LEST. Pal 


oF 


7) 
a 


FASE 2 


oO? 


oO 


VOOOOO ERRORS 


ACL ARTA 6 ORE RETR ALR 6 ARIEL Py LR Se 6 PALE 


QO? 


ay 
Qi 


Sot aE Gackt Go ZY 
PASS 2 


OP 


GOGOOG ERRORS 


/f 
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(Mount cassette with LPS3.PAL 
on unit 0) 

(Mount cassette with 
PERPAR.PAL on unit 0) 

(Mount cassette with LPS4.PAL 
on unit 0) 

(Mount cassette with 
PERPAR.PAL on unit 0) 

(Mount cassette with LPS4.PAL 


on unit 0) 


assemble the ARD files instead of LPS files: 


(Mount cassette with 
PERPAR.ARD on unit 0) 

(Mount cassette with LPS1.PAL 
on unit 0) 

(Mount cassette with 
PERPAR.ARD on unit 0) 

(Mount cassette with LPS1]1.PAL 
on unit 0) 

(Mount cassette with 
PERPAR.ARD on unit 0) 

(Mount cassette with LPS2.PAL 
on unit 0) 

(Mount cassette with 
PERPAR.ARD on unit 0) 

(Mount cassette with LPS2.PAL 


on unit 0) 
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ELIARTLC OBIE OP PERF AR. ARTUR y PARAM. FAL ZF e LP S2. PAL AF 


oO? (Mount cassette with 
PERPAR.ARD and PARAM.PAL on 
unit 0) 

OP (Mount cassette with LPS2.PAL 


on unit 0) 


FASS 2 


Oo? (Mount cassette with 
PERPAR.ARD and PARAM.PAL on 
unit 0) 

QO? (Mount cassette with LPS2.PAL 


on unit 0) 


000000 ERRORS 


KLIARTINS. ORG PERE AR. ARTIZP y LPS. False 

OF (Mount cassette with 
PERPAR.ARD on unit 0) 

QP (Mount cassette with LPS3.PAL 


on unit 0) 
FASS 3 


QP? (Mount cassette with 
PERPAR.ARD on unit 0) 


ov (Mount cassette with LPS3.PAL 
on unit Q) 


000000 ERRORS 


Building a load module may now be accomplished by following the 
instructions in the preceding paragraphs. 


B.3 BASIC/PTS-11 


B.3.1 LPS Support 


The LPS support for paper tape is supplied in twelve binary tapes: 


LPSO.OBJ Required LPS kernel module for LPS1l1 or 
AR11 and DR11-K 

LPS1.OBJ Optional Analog to digital conversion 
for LPS11 

ARD1.OBJ Optional Analog to digital conversion 


for AR11 and DR11-K 
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LPS2.OBJ Real-time clock (60 Hz line 
frequency) for LPS11 

ARD2.OBJ Real-time clock (60 Hz line 

One is required frequency) for AR11 and DR11-K 

LPS2C.OBJ Real-time clock (50 Hz line 
frequency) for LPS11 

ARD2C.OBJ Real-time clock (50 Hz line 
frequency) for AR1I1 and DR11-K 

LPS3.OBJ Optional Digital input/output for LPS1ll 

ARD3.OBJ Optional Digital input/output for ARI11 
and DR11-K 

LPS4.OBJ Optional Display for LPS11 or AR11 and 
DR11-K 

PTSSTR One is Patch for BASIC with strings 

PTSNST required Patch for BASIC without 
strings 


The following files are provided in source form: 


FTBL.MAC Function Table Module 
PERVEC.MAC Vector Definition Module 
PTSINT.MAC Interface Module 
PERPAR.MAC Parameter 


To build a load module BASLPS (BASIC with LPS support), the parameter 
file PERPAR.MAC is edited and then assembled with FTBL, PERVEC and the 
appropriate interface module. The six object modules produced are 
then linked with the LPS and BASIC object modules to produce a load 
module. The specific instructions that are given to the system 
programs (editor, assembler, and linker) are given in the examples 
that follow the general description of load module building. 


The two patch tapes, PTSSTR and PTSNST, alter one location in BASICL 
to permit the LPS scope to be refreshed by a background routine, a 
routine that is active while BASIC waits for input. A patch tape 
should only be used with BASIC/PTS VO1l. The Patch tape used should be 
linked after the last LPS tape. PTSNST should be linked when BASICL 
without strings is linked and PTSSTR should be linked when BASICL with 
strings is linked. 


NOTE 


All of the procedures in this section 
assume that an unaltered PERPAR is being 
edited. It is recommended that a copy 
of the original PERPAR be made and saved 
for future use. 


The BASINT interface module should be used with all versions of BASIC 
except BASIC/PTS V0Ol which should have PTSINT used in the place of 
BASINT. 


For the LPS routines to be accessible from the BASIC CALL statement, 
the routine must be defined in a System Function Table. FTBL.MAC is a 
function table in source form. If any user-written assembly language 
routines are also linked with BASIC the routines must be defined in 
this function table. 


PERVEC is the vector definition module. It defines the hardware 


addresses of the status registers and the interrupt vectors. The 
Standard hardware address for the LPS interrupt vector is 340 (octal). 
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In PDP-11E10 machines with LPS support, however, the interrrupt vector 
is location 300 (octal). To assemble PERVEC with the interrupt vector 
at 300 (octal) it is necessary to delete the semicolon before the SV=0 
definition in PERPAR.MAC. If the interrupt locations are at another 
location in memory then correct the interrupt addresses by using the 
system editor to define $V in PERPAR equal to the interrupt address 
minus 300 (octal). For example, if the LPS interrupt vectors start at 
320 (octal) define S$V=20 (octal). 


To link the LPS module with BASIC, it is necessary to delete the 
semicolons (;) before the SLPS=0 statement. If any of the four 
optional modules are not to be included, a semicolon (;) must be 
inserted before the appropriate conditional. 


Parameter Insert ; before parameter if 

SADC=0 module LPS1 or AR11 is not to be included. 

SCLK=0 module LPS2 (LPS2C) or AR11 is not to be included. 
$DIO=0 module LPS3 or AR11 is not to be included. 

SDIS=0 module LPS4 or AR11 is not to be included. 
SSTRNG=0 no string version of BASICL is to be linked. 


Using the system assembler, the sources are assembled in the following 
combinations to produce the needed LPS object modules: 


Object File Source Files 
FTBL PERPAR,FTBL 
PERVEC PERPAR, PERVEC 
BASINT or PERPAR, BASINT 
PTSINT PERPAR, PTSINT 


After these modules have been assembled, the LPS support may be linked 
with the BASIC object modules with only the desired optional LPS 
modules included in the LINK command strings. 


Example Load Buildings 


Examples are given for building a load module for the following three 
systems: 


1. BASIC with strings, with complete LPS (or AR11) Support, and 
with the LPS (or ARI11) interrupt vectors located at 340 
(octal). 


2. BASIC without strings with complete LPS (or AR11) support and 
with the LPS (or _ ARI11) interrupt vectors located at 300 
(octal). 


3. BASIC with strings, with a partial LPS (or AR11) 
configuration (one that includes the ADC, DIS, and CLK but 
does not include the DIO), and with the LPS (or ARI1I1) 
interrupt vectors located at 340 (octal). 
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To build a load module called BASLPS.LDA, the following instructions 
should be followed: 


Load ED-11 (the PDP-11 Paper Tape Software Text Editor) which is’ used 
to edit a source paper tape, PERPAR, which describes the required 
options. Place the supplied PERPAR.MAC in the high speed paper tape 
reader then follow one of these three procedures: 


l. For a load module of BASIC including strings with support for 
a complete configuration of the LPS (all four optional 
modules) and with the LPS interrupt vectors at location 340 
(octal), the following instructions should be given to the 
editor: 


*T H 

*Ct H 

oy 

#H 

; $C AF S=G6 
i €CAPS=4 
GA 

* (Ci 

+H 

i €LPS=8 
i $LPS=6 
+ AF 


* (Cr 


At this point, the punch has the edited PERPAR. 

2. Or for a load module of BASIC with no strings, with support 
for a complete configuration of the LPS and with the LPS 
vectors located at 300 (octal), the following instructions 
should be given to the editor: 


*l H 

*Ci H 

+ ke 

1H 

i $CAPS=6@ 
i $CAPS=@ 
*BA 


*D 
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+H 
£STRNG=G 
$STRNG=e 
*BA 


*T 


j 


*#H 
i; $LPS=@ 
i €LPS=@ 
AF 


*D 

#H 

i €¥=@ 
i €V=8 
+A 


* OD) 


#6 


At this point the punch has the edited PERPAR. 


Or to build a load module 
configuration of the LPS, 
CLK but excludes the DIO 

(octal), the following 

editor: 


TH 
"Cl H 

+R 

#H 

i €CAPS=6 
i $CAPS=A 
+BA 

*O 

*H 

i; $LPSsa 
i $LES=& 
*HA 

*( 

*#H 


fO010=@ 
#C1O=@ 


of BASIC with strings for a partial 
one that includes the ADC, DIS, and 
with the LPS interrupts at 340 
instructions should be given the 
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+A 


#7 


#E 
“Pp 
dT 
. 
At thi 


Load PAL-11S. 


s point, the punch has the edited PERPAR. 


It is used to generate FTBL, PERVEC, and PTSINT object 


tapes. When PAL-11l has been loaded, put the edited PERPAR tape in the 


high-speed read 


PAL-1 
*S 4H 
*B 
“ti; .P 
a. 
The P 

EOF? 

END? 

EOF? 

000000 ERR 

PAL-115 

*S 

PAL-115 


These steps are 
produce a PERV 
and PTSINT tape 


Building the lo 
bottom address 


Link the object 


BASICL.OBJ 


er and answer the following questions. 


1s 


ERPAR tape is now read. 


When EOF? is printed, remove the PERPAR tape and put 
the FTBL source tape in the high-speed reader. Then 
type catriage return. 


When END? is printed, remove the FTBL source tape and 
insert the PERPAR tape in the high-speed reader. When 
ready, type a carriage return. 


When EOF? is printed, remove the PERPAR tape. and 
replace it with the FTBL source tape. (Note that both 
tapes are loaded twice in the assembly process.) 


ORS 


When *S is printed, the new FTBL object tape is in the 
high-speed punch and may be removed. It is this tape 
(called FTBL) that will be used in the linking process 
to generate a new load module. 


then repeated using the PERPAR and PERVEC tapes to 
EC object tape and then repeated again using the PERPAR 
s to produce a PTSINT object tape. 


ad module is accomplished by using LINK-11S. The 
specified should be 400. 


tapes in the following order. 
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FPMP.OBJ 

PTSINT.OBJ 

PERVEC.OBJ 

FTBL.OBJ 

LPSO.OBJ 

LPS1.OBJ or ARD1.OBJ 

LPS2.OBJ or ARD2.OBJ (for 60 Hz line frequency) 
LPS2C.OBJ or ARD2C.OBJ (for 50 Hz line frequency) 
LPS3.OBJ or ARD3.OBJ 

LPS4.0OBJ 

PTSNST 

BASICH.OBJ 


If SSTRNG was left unchanged when editing PERPAR, BASICL with’ strings 
must be used. If a semicolon was inserted before S$STRNG, BASICL for 
no string must be used. 


Exclude the optional files for which a semicolon was inserted before 
the appropriate conditional in PERPAR. In the example given for a 
configuration not including the DIO, do not include LPS3.OBJ in the 
linking process. 


To assemble the LPS from the sources the following procedure should be 
followed: 


Load PAL-11S. It is used to generate LPSO, LPS1, LPS2, LPS3, and LPS4 
binary tapes. Put the LPSO source tape in the high speed reader. 
Enter the following commands 


PAL-118S 

*S oH 

*B A 

*i, P 

*T Pp The tape is now read. 

END? Re-insert the tape in the reader, press <CR> 
000000 

PAL-11S 

*S 


Repeat this procedure for the LPS1, LPS2(LPS2C), LPS3, and LPS4 source 
tapes or if the line frequency is 50 Hz, LPS2 should be assembled by 
the following procedure (LPSO, LPS1,LPS3, and LPS4 are still assembled 
as described above). Load ED-1ll (the PDP-1l Paper Tape Software 
Editor) with the absolute loader, then create a parameter tape as 
follows: 


Aa Hi 
*O H 
<1 
CYC50=0 
- EOT 
<8 
*/P 


* AT 
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Load the PAL-11S assembler and insert the tape created by the above 
commands. Follow this procedure: 


PAL~115S 


*S 4H 
*B HH 
Lo am 3 
*T ?P 
EOF? 
END? 


EOF? 
000000 


PAL-118 
*S 


Insert the LPS2 source tape and press <CR>. 
Insert the tape created by the editor and press 


<CR>. 


Insert the LPS2 source tape and press <CR>. 


At this point the LPS2 binary tape is in the 


high-speed punch. 


The following table lists the assembly parameters for each module: 


Source File 
LPSO.MAC 


LPS1.MAC 


LPS2.MAC 


LPS3.MAC 
LPS4.MAC 


VT55.MAC 
Source File 


FTBL.MAC 


PERVEC.MAC 


Conditionals 


None 


SAR11 
SCAPS 


CYC50 


SAR11 
SCAPS 


SAR11 
None 


VT55 
Conditionals 


SADC 
SCLK 
$DIO 
SDIS 
SLPS 


$vT11 
SDISK 
$VT55 


SLPS 

SV 

S$VT1l 
SAR11 
SDR11K 
SNUMBR=X 


OFFST1 


OFFST2 
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AR11 hardware 
PTS hardware 


50Hz line frequency (60 
Hz is default) 

AR11 hardware 

PTS hardware 


AR11 hardware 


VT55 terminal 
Define for Systems with: 


LPSl 

LPS2 

LPS3 

LPS4 

SLPSO (all systems with 
LPS support) 

VT11 support 

RT-11 

VT55 support 


LPS1ll hardware 

LPS interrupts not at 
location 340 (octal) 

VT11 support 

AR11 hardware 

DR11-K hardware 

Multiple (X) DR11-K 
hardware 

First DR11-K interrupt 
address not at 167770 
(octal) 

First DR11-K vector 


PTSINT.MAC 


BUILDING LOAD MODULES 


address not at 300 
(octal) 


$DIS LPS4 


To include AR11, simply define $AR11 in addition to $CAPS symbols in 


PERPAR Source tape. 
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APPENDIX C 


ERROR MESSAGES 


This appendix summarizes the error messages that may occur when’ using 
BASIC Extensions call routines. See Appendix P of the RT-11 System 
Reference Manual for all error messages that may occur under the RT-I11 
system. 


PADC ERROR AT LINE XXXXX 
BASIC Ext Fatal Cannot issue ADC command while an _ RTS 
operation is underway. 


?ARG ERROR AT LINE XXXXX 
BASIC Fatal Arguments in a function call do not match 
(in number or in type) the argument defined 
for the function. 


?BUF ERROR AT LINE XXXXX 
BASIC Ext Fatal Buffer name given in LPS command has not 
been previously defined in a USE statement. 


?DEV ERR-C 
BASIC Ext Non--fatal The device specified is illegal. 


?DSP ERROR AT LINE XXXXX 


BASIC Ext Fatal -DEVICE list space overflow. Redefine 
DSPSIZ in PERPAR.MAC and reassemble 
FTBL.MAC. 
?DVO ERROR AT LINE XXXXX 
BASIC Fatal Program attempted to divide some quantity 
by 0. 
?NOR ERROR AT LINE XXXXX 
BASIC Ext Fatal Number out of range. 
?SYN ERROR AT LINE XXXXX 
BASIC Fatal The program has encountered an 
unrecognizable statement. Common syntax 
errors are mispelled commands and unmatched 
parentheses, and other typographical 
errors. 


P?UNF ERROR FUNCTION AT LINE XXXXxX 
BASIC Fatal The function called was not defined by the 
program or was not loaded with BASIC. 


Term 


Analog 


Auto-gain 


Bipolar 


Buffer 


Clock 


DMA 


Gain 


Global 


Initialize 


Library 
Routine 


Mass Storage 


Overflow 


Parameter 


GLOSSARY 


Definition 


Numbers represented by directly measurable 
(as voltages, resistances, or rotations). 


guantities 
Software determination of the best switch gain value to 
use sampling analog data using the LPSAM-SG option. 


Refers to a signal that is either positive or 
with respect to system ground. 


negative 


A temporary storage area _ which 
register or an area of storage. 


may be ae special 


A time-keeping or frequency-measuring device within the 
computer system. 


Direct Memory Access. The DMA is attached to any 
PDP-11 allowing memory data storage or retrieval at 
memory cycle speeds without processor intervention. 

ratio of 


An increase in signal power. Gain in the 


output power to input power. 

A value defined in one program module and used in 
others. Globals are often referred to as "entry 
points" in the module in which they are defined and 
"axternals" in the other modules which use them. 

To set counters, switches, addresses and variables to 
zero or other starting values. 

A collection of standard routines which can _ be 
incorporated into larger programs. 


Pertaining to a device such as a disk or DECtape which 
stores large amounts of data readily accessible to the 
central processing unit. 


A condition that occurs when a mathematical 
yields a result whose magnitude 
program is capable of handling. 


operation 
is larger than the 


A variable or an arbitrary constant appearing in a 
mathematical expression, each value of which restricts 
or determines the specific form of the expression. 


Glossary-1 


Preamplifier 


Source file 


GLOSSARY 


An electronic circuit or device that detects and 
sufficiently amplifies weak signals. 


A file to be used as input to a translating program 
such as MACRO or BASIC. 


Glossary-2 


INDEX 


A/D Conversion, 2-7 
ACC, 2-2, 2-5 
ADC, 2-1, 2-2, 
Array, 2-3 

Auto-gain, 2-7 


2-7 


Background Display Routine, 2-23 
Buffer, 
defining the display, 2-22 
display, 2-25 
putting data into display, 


2-23 
ring, 2-6, 2-8, 2-15 
Burst Mode, 2-10 
Channel, 2-8 
Clock, 2-1, 2-10 
Clock, 
internal, 2-16 


Clock Mode, 2-14 
CLRD, 2-2, 2-22 
Control, 

relay, 2-21 
Conversion, 

A/D, 2-7 


CVSG, 2-2, 2-12 


DACS, 2-2 
Data, 
flashing, 2-26 
returning, 2-6 
Data from memory, 
reading, 2-21 
Data into display buffer, 
putting, 2-23 
Data into memory, 
writing, 2-21 
Data overrun, 2-6 
Defining the display buffer, 2-22 
Digital readout, 2-19 
DIM, 2-3 
DIR, 2-2, 2-17 
DIS, 2-3, 2-23 
Display buffer, 2-25 
defining the, 2-22 
putting data into, 
Display routine, 
background, 2-23 
DMA, 2-1, 2-11 
DOR, 2-2, 2-19 


2~23 


Flashing data, 2-26 
FSH, 2-3, 2-25 
FXY, 2-3, 2-26 


2-27 
2-16 
2-15 


Hardware, 
HIST, 2-2, 
Histograms, 


2-16 
2-13 


Internal clock, 
Interrupt Mode, 
IPK, 2-2, 2-21 


LED, 2-1, 2-2, 2-11 

Light Emitting Diodes, 2-11 
LPSO, 2-3 

LPS1, 2-7 

LPS2, 2-12 

LPS3, 2-17 

LPS4, 2-22 

LPSAD~12, 
LPSAD-NP 
LPSAG, 2 
LPSAG-VG 
LPSAM, 2 
LPSDR, 2 
LPSKW, 2 
LPSSH, 2 
LPSVC, 2 


Memory, 
reading data from, 
writing data into, 

Mode, 

Burst, 2-10 
Clock, 2-14 
Interrupt, 


2-21 
2-21 


2-13 


Numeric readouts, 2-7 


Index~-1 


INDEX (Cont.) 


Overflow, 2-16 
Overrun, 
data, 2-6 


PUTD, 2-2, 2-23 
Putting data into display 
buffer, 2-23 


RDB, 2-2, 2-6 
Reading data from memory, 2-21 
Readout, 

digital, 2-19 
Readouts, 

numeric, 2-7 
Real-time sampling, 2-7, 2-8 
REL, 2-2, 2-21 
Relay control, 2-21 
Retrigger, 2-17 
Returning data, 2-6 
Ring buffer, 2-6, 2-8, 2-15 
Routine, 

background display, 2-23 
RTIM, 2-2, 2-16 
RTS, 2=2 


Sampling, 

real-time, 2-7, 2-8 
Schmitt Trigger, 2-1, 2-10 
Schmitt Trigger, 

timed, 2-15 
SETC, 2-2, 2-14 
SETR, 2-2, 2-12, 2-13 
Subscript, 2-3 
SVSG, 2-12 


Target variable, 2-6, 2-7, 2-17 
Timed Schmitt Trigger, 2-15 


USE, 2-2, 2-3 


Variable, 
target, 2-6, 2-7, 2-17 


WAIT, 2-2, 2-16 
Writing data into memory, 2-21 


Index-2 


Please cut alon 
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READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 
with software should be reported on a Software 
Problem Repcrt (SPR) form. 


Did you find errors in this manual? If so, specify by page. 














Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 

















Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 
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Student programmer 
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Non-programmer interested in computer concepts and capabilities 
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Organization 





Street 





Ce se SHA 8 A Code 
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